improve reference-to-guide links
svn: r6497
This commit is contained in:
parent
0b9493032b
commit
a0cee55f56
|
@ -17,7 +17,7 @@ procedure that creates a pair, @scheme[car] refers to the procedure
|
|||
that extracts the first element of a pair, and so on.
|
||||
|
||||
@margin-note{For information on the syntax of identifiers, see
|
||||
@secref["symbols"].}
|
||||
@secref["guide:symbols"].}
|
||||
|
||||
Forms like @scheme[define], @scheme[lambda], and @scheme[let]
|
||||
associate a meaning with one or more identifiers; that is, they
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
@require[(lib "eval.ss" "scribble")]
|
||||
@require["guide-utils.ss"]
|
||||
|
||||
@title[#:tag "bytes"]{Bytes and Byte Strings}
|
||||
@title[#:tag "guide:bytestrings"]{Bytes and Byte Strings}
|
||||
|
||||
A @defterm{byte} is an inexact integer between @scheme[0] and
|
||||
@scheme[255], inclusive. The @scheme[byte?] predicate recognizes
|
||||
|
@ -15,11 +15,11 @@ numbers that represent bytes.
|
|||
]
|
||||
|
||||
A @defterm{byte string} is similar to a string---see
|
||||
@secref["strings"]---but its content is a sequence of bytes instead of
|
||||
characters. Byte strings can be used in applications that process pure
|
||||
ASCII instead of Unicode text. The printed and form of a byte string
|
||||
supports such uses in particular, because a byte string prints like
|
||||
the ASCII decoding of the byte string, but prefixed with a
|
||||
@secref["guide:strings"]---but its content is a sequence of bytes
|
||||
instead of characters. Byte strings can be used in applications that
|
||||
process pure ASCII instead of Unicode text. The printed and form of a
|
||||
byte string supports such uses in particular, because a byte string
|
||||
prints like the ASCII decoding of the byte string, but prefixed with a
|
||||
@schemefont{#}. Unprintable ASCII characters or non-ASCII bytes in the
|
||||
byte string are written with octal notation.
|
||||
|
||||
|
|
|
@ -3,10 +3,10 @@
|
|||
@require[(lib "eval.ss" "scribble")]
|
||||
@require["guide-utils.ss"]
|
||||
|
||||
@title[#:tag "strings"]{Strings (Unicode)}
|
||||
@title[#:tag "guide:strings"]{Strings (Unicode)}
|
||||
|
||||
A @defterm{string} is a fixed-length array of
|
||||
@seclink["characters"]{characters}. It prints using doublequotes,
|
||||
@seclink["guide:characters"]{characters}. It prints using doublequotes,
|
||||
where doublequote and backslash characters within the string are
|
||||
escaped with backslashes. Other common string escapes are supported,
|
||||
incluing @schemefont["\\n"] for a linefeed, @schemefont["\\r"] for a
|
||||
|
@ -65,7 +65,7 @@ for an end user.
|
|||
]
|
||||
|
||||
For working with plain ASCII, working with raw bytes, or
|
||||
encoding/decoding Unicode strings as bytes, use @seclink["bytes"]{byte
|
||||
strings}.
|
||||
encoding/decoding Unicode strings as bytes, use
|
||||
@seclink["guide:bytestrings"]{byte strings}.
|
||||
|
||||
@refdetails["mz:strings"]{strings and string procedures}
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
@require[(lib "eval.ss" "scribble")]
|
||||
@require["guide-utils.ss"]
|
||||
|
||||
@title[#:tag "characters"]{Characters}
|
||||
@title[#:tag "guide:characters"]{Characters}
|
||||
|
||||
A Scheme @defterm{character} corresponds to a Unicode @defterm{scalar
|
||||
value}. Roughly, a scalar value is an unsigned integer whose
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
@require[(lib "eval.ss" "scribble")]
|
||||
@require["guide-utils.ss"]
|
||||
|
||||
@title{Numbers}
|
||||
@title[#:tag "guide:numbers"]{Numbers}
|
||||
|
||||
A Scheme @defterm{number} is either exact or inexact:
|
||||
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
@require[(lib "eval.ss" "scribble")]
|
||||
@require["guide-utils.ss"]
|
||||
|
||||
@title[#:tag "symbols"]{Symbols}
|
||||
@title[#:tag "guide:symbols"]{Symbols}
|
||||
|
||||
A @defterm{symbol} is an atomic value that prints like an identifier.
|
||||
An expression that starts with @litchar{'} and continues with an
|
||||
|
|
|
@ -3,6 +3,8 @@
|
|||
|
||||
@title[#:tag "mz:bytestrings"]{Byte Strings}
|
||||
|
||||
@guideintro["guide:bytestrings"]{byte strings}
|
||||
|
||||
A @pidefterm{byte string} is a fixed-length arary of bytes. A
|
||||
@pidefterm{byte} is an exact integer between @scheme[0] and
|
||||
@scheme[255] inclusive.
|
||||
|
|
|
@ -3,5 +3,7 @@
|
|||
|
||||
@title[#:tag "mz:characters"]{Characters}
|
||||
|
||||
@guideintro["guide:characters"]{characters}
|
||||
|
||||
A @pidefterm{character} corresponds to a Unicode scalar value (i.e., a
|
||||
Unicode code point that is not a surrogate).
|
||||
|
|
|
@ -36,6 +36,8 @@ is @scheme[#t] or @scheme[#f], @scheme[#f] otherwise.}
|
|||
@; ------------------------------------------------------------
|
||||
@section[#:tag "symbols"]{Symbols}
|
||||
|
||||
@guideintro["guide:symbols"]{symbols}
|
||||
|
||||
A symbol is like an immutable string, but symbols are normally
|
||||
@index["interned symbols"]{@defterm{interned}}, so that two symbols
|
||||
with the same character content are normally @scheme[eq?]. All symbols
|
||||
|
|
|
@ -3,6 +3,8 @@
|
|||
|
||||
@title[#:tag "mz:numbers"]{Numbers}
|
||||
|
||||
@guideintro["guide:numbers"]{numbers}
|
||||
|
||||
All numbers are @idefterm{complex numbers}. Some of them are
|
||||
@idefterm{real numbers}, and all of the real numbers that can be
|
||||
represented are also @idefterm{rational numbers}. Among the real
|
||||
|
|
|
@ -155,6 +155,8 @@ on the next character or characters in the input stream as follows:
|
|||
|
||||
@section[#:tag "mz:parse-symbol"]{Reading Symbols}
|
||||
|
||||
@guideintro["guide:symbols"]{the syntax of symbols}
|
||||
|
||||
A sequence that does not start with a delimiter or @litchar{#} is
|
||||
parsed as either a symbol or a number (see @secref["mz:parse-number"]),
|
||||
except that @litchar{.} by itself is never parsed as a symbol or
|
||||
|
@ -185,6 +187,8 @@ the following datum in case-sensitive mode.
|
|||
|
||||
@section[#:tag "mz:parse-number"]{Reading Numbers}
|
||||
|
||||
@guideintro["guide:numbers"]{the syntax of numbers}
|
||||
|
||||
@index['("numbers" "parsing")]{A} sequence that does not start with a
|
||||
delimiter is parsed as a number when it matches the following grammar
|
||||
case-insenstively for @nonterm{number@sub{10}} (decimal), where
|
||||
|
@ -348,6 +352,8 @@ then when then reader encounters @litchar["{"] and @litchar["}"], the
|
|||
|
||||
@section[#:tag "mz:parse-string"]{Reading Strings}
|
||||
|
||||
@guideintro["guide:strings"]{the syntax of strings}
|
||||
|
||||
@index['("strings" "parsing")]{When} the reader encouters
|
||||
@as-index{@litchar{"}}, it begins parsing characters to form a string. The
|
||||
string continues until it is terminated by another @litchar{"} (that
|
||||
|
@ -412,9 +418,11 @@ Within a string sequence, the following escape sequences are
|
|||
|
||||
}
|
||||
|
||||
If the reader encounteres any other use of a backslashe in a string
|
||||
If the reader encounteres any other use of a backslash in a string
|
||||
constant, the @exnraise[exn:fail:read].
|
||||
|
||||
@guideintro["guide:bytestrings"]{the syntax of byte strings}
|
||||
|
||||
@index['("byte strings" "parsing")]{A} string constant preceded by
|
||||
@litchar{#} is parsed as a byte-string. (That is, @as-index{@litchar{#"}} starts
|
||||
a byte-string literal.) See @secref["mz:bytestrings"] for
|
||||
|
@ -578,6 +586,8 @@ content is also wraped as a syntax object.
|
|||
|
||||
@section[#:tag "mz:parse-character"]{Reading Characters}
|
||||
|
||||
@guideintro["guide:characters"]{the syntax of characters}
|
||||
|
||||
A @litchar["#\\"] starts a character constant, which has one of the
|
||||
following forms:
|
||||
|
||||
|
|
|
@ -3,6 +3,8 @@
|
|||
|
||||
@title[#:tag "mz:strings"]{Strings}
|
||||
|
||||
@guideintro["guide:string"]{strings}
|
||||
|
||||
A @pidefterm{string} is a fixed-length arary of
|
||||
@seclink["characters"]{characters}.
|
||||
|
||||
|
|
Loading…
Reference in New Issue
Block a user