steve
/
factor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Minor updates to string documentation

db4
Slava Pestov 2010-02-03 23:07:53 +13:00
parent ed9251c56c
commit e32d5fd0ac
3 changed files with 7 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
basis/unicode/summary.txt
View File

@ -1 +1 @@
Unicode 5.1 support
Unicode 5.2 support

11
core/strings/strings-docs.factor
View File

@ -4,13 +4,9 @@ sbufs math help.vocabs ;
IN: strings
ARTICLE: "strings" "Strings"
"The " { $vocab-link "strings" } " vocabulary implements fixed-size mutable sequences of of Unicode 5.1 code points."
"The " { $vocab-link "strings" } " vocabulary implements a data type for storing text. Strings are represented as fixed-size mutable sequences of Unicode code points. Code points are represented as integers in the range [0,2,097,152]."
$nl
"Code points, or characters as they're informally known, are not a first-class type; they are simply represented as integers in the range 0 and 16,777,216 (2^24), inclusive. Only characters up to 2,097,152 (2^21) have a defined meaning in Unicode."
$nl
"String literal syntax is covered in " { $link "syntax-strings" } "."
$nl
"Since strings implement the " { $link "sequence-protocol" } ", basic string manipulation can be performed with " { $link "sequences" } " in the " { $vocab-link "sequences" } " vocabulary. More text processing functionality can be found in vocabularies carrying the " { $link T{ vocab-tag { name "text" } } } " tag."
"Strings implement the " { $link "sequence-protocol" } ", and basic string manipulation can be performed with " { $link "sequences" } " from the " { $vocab-link "sequences" } " vocabulary. More text processing functionality can be found in vocabularies carrying the " { $link T{ vocab-tag { name "text" } } } " tag."
$nl
"Strings form a class:"
{ $subsections
@ -23,7 +19,8 @@ $nl
<string>
}
"Creating a string from a single character:"
{ $subsections 1string } ;
{ $subsections 1string }
{ $see-also "syntax-strings" "sbufs" "unicode" "io.encodings" } ;
ABOUT: "strings"

4
core/syntax/syntax-docs.factor
View File

@ -129,7 +129,7 @@ ARTICLE: "escape" "Character escape codes"
} ;
ARTICLE: "syntax-strings" "Character and string syntax"
"Factor has no distinct character type, however Unicode character value integers can be read by specifying a literal character, or an escaped representation thereof."
"Factor has no distinct character type. Integers representing Unicode code points can be read by specifying a literal character, or an escaped representation thereof."
{ $subsections
POSTPONE: CHAR:
POSTPONE: "
@ -537,7 +537,7 @@ HELP: IN:
HELP: CHAR:
{ $syntax "CHAR: token" }
{ $values { "token" "a literal character, escape code, or Unicode character name" } }
{ $values { "token" "a literal character, escape code, or Unicode code point name" } }
{ $description "Adds a Unicode code point to the parse tree." }
{ $examples
{ $code