improve reference-to-guide links

svn: r6497
This commit is contained in:
Matthew Flatt 2007-06-06 01:39:36 +00:00
parent 0b9493032b
commit a0cee55f56
12 changed files with 35 additions and 15 deletions

View File

@ -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. that extracts the first element of a pair, and so on.
@margin-note{For information on the syntax of identifiers, see @margin-note{For information on the syntax of identifiers, see
@secref["symbols"].} @secref["guide:symbols"].}
Forms like @scheme[define], @scheme[lambda], and @scheme[let] Forms like @scheme[define], @scheme[lambda], and @scheme[let]
associate a meaning with one or more identifiers; that is, they associate a meaning with one or more identifiers; that is, they

View File

@ -3,7 +3,7 @@
@require[(lib "eval.ss" "scribble")] @require[(lib "eval.ss" "scribble")]
@require["guide-utils.ss"] @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 A @defterm{byte} is an inexact integer between @scheme[0] and
@scheme[255], inclusive. The @scheme[byte?] predicate recognizes @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 A @defterm{byte string} is similar to a string---see
@secref["strings"]---but its content is a sequence of bytes instead of @secref["guide:strings"]---but its content is a sequence of bytes
characters. Byte strings can be used in applications that process pure instead of characters. Byte strings can be used in applications that
ASCII instead of Unicode text. The printed and form of a byte string process pure ASCII instead of Unicode text. The printed and form of a
supports such uses in particular, because a byte string prints like byte string supports such uses in particular, because a byte string
the ASCII decoding of the byte string, but prefixed with a prints like the ASCII decoding of the byte string, but prefixed with a
@schemefont{#}. Unprintable ASCII characters or non-ASCII bytes in the @schemefont{#}. Unprintable ASCII characters or non-ASCII bytes in the
byte string are written with octal notation. byte string are written with octal notation.

View File

@ -3,10 +3,10 @@
@require[(lib "eval.ss" "scribble")] @require[(lib "eval.ss" "scribble")]
@require["guide-utils.ss"] @require["guide-utils.ss"]
@title[#:tag "strings"]{Strings (Unicode)} @title[#:tag "guide:strings"]{Strings (Unicode)}
A @defterm{string} is a fixed-length array of 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 where doublequote and backslash characters within the string are
escaped with backslashes. Other common string escapes are supported, escaped with backslashes. Other common string escapes are supported,
incluing @schemefont["\\n"] for a linefeed, @schemefont["\\r"] for a 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 For working with plain ASCII, working with raw bytes, or
encoding/decoding Unicode strings as bytes, use @seclink["bytes"]{byte encoding/decoding Unicode strings as bytes, use
strings}. @seclink["guide:bytestrings"]{byte strings}.
@refdetails["mz:strings"]{strings and string procedures} @refdetails["mz:strings"]{strings and string procedures}

View File

@ -3,7 +3,7 @@
@require[(lib "eval.ss" "scribble")] @require[(lib "eval.ss" "scribble")]
@require["guide-utils.ss"] @require["guide-utils.ss"]
@title[#:tag "characters"]{Characters} @title[#:tag "guide:characters"]{Characters}
A Scheme @defterm{character} corresponds to a Unicode @defterm{scalar A Scheme @defterm{character} corresponds to a Unicode @defterm{scalar
value}. Roughly, a scalar value is an unsigned integer whose value}. Roughly, a scalar value is an unsigned integer whose

View File

@ -3,7 +3,7 @@
@require[(lib "eval.ss" "scribble")] @require[(lib "eval.ss" "scribble")]
@require["guide-utils.ss"] @require["guide-utils.ss"]
@title{Numbers} @title[#:tag "guide:numbers"]{Numbers}
A Scheme @defterm{number} is either exact or inexact: A Scheme @defterm{number} is either exact or inexact:

View File

@ -3,7 +3,7 @@
@require[(lib "eval.ss" "scribble")] @require[(lib "eval.ss" "scribble")]
@require["guide-utils.ss"] @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. A @defterm{symbol} is an atomic value that prints like an identifier.
An expression that starts with @litchar{'} and continues with an An expression that starts with @litchar{'} and continues with an

View File

@ -3,6 +3,8 @@
@title[#:tag "mz:bytestrings"]{Byte Strings} @title[#:tag "mz:bytestrings"]{Byte Strings}
@guideintro["guide:bytestrings"]{byte strings}
A @pidefterm{byte string} is a fixed-length arary of bytes. A A @pidefterm{byte string} is a fixed-length arary of bytes. A
@pidefterm{byte} is an exact integer between @scheme[0] and @pidefterm{byte} is an exact integer between @scheme[0] and
@scheme[255] inclusive. @scheme[255] inclusive.

View File

@ -3,5 +3,7 @@
@title[#:tag "mz:characters"]{Characters} @title[#:tag "mz:characters"]{Characters}
@guideintro["guide:characters"]{characters}
A @pidefterm{character} corresponds to a Unicode scalar value (i.e., a A @pidefterm{character} corresponds to a Unicode scalar value (i.e., a
Unicode code point that is not a surrogate). Unicode code point that is not a surrogate).

View File

@ -36,6 +36,8 @@ is @scheme[#t] or @scheme[#f], @scheme[#f] otherwise.}
@; ------------------------------------------------------------ @; ------------------------------------------------------------
@section[#:tag "symbols"]{Symbols} @section[#:tag "symbols"]{Symbols}
@guideintro["guide:symbols"]{symbols}
A symbol is like an immutable string, but symbols are normally A symbol is like an immutable string, but symbols are normally
@index["interned symbols"]{@defterm{interned}}, so that two symbols @index["interned symbols"]{@defterm{interned}}, so that two symbols
with the same character content are normally @scheme[eq?]. All symbols with the same character content are normally @scheme[eq?]. All symbols

View File

@ -3,6 +3,8 @@
@title[#:tag "mz:numbers"]{Numbers} @title[#:tag "mz:numbers"]{Numbers}
@guideintro["guide:numbers"]{numbers}
All numbers are @idefterm{complex numbers}. Some of them are All numbers are @idefterm{complex numbers}. Some of them are
@idefterm{real numbers}, and all of the real numbers that can be @idefterm{real numbers}, and all of the real numbers that can be
represented are also @idefterm{rational numbers}. Among the real represented are also @idefterm{rational numbers}. Among the real

View File

@ -155,6 +155,8 @@ on the next character or characters in the input stream as follows:
@section[#:tag "mz:parse-symbol"]{Reading Symbols} @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 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"]), 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 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} @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 @index['("numbers" "parsing")]{A} sequence that does not start with a
delimiter is parsed as a number when it matches the following grammar delimiter is parsed as a number when it matches the following grammar
case-insenstively for @nonterm{number@sub{10}} (decimal), where 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} @section[#:tag "mz:parse-string"]{Reading Strings}
@guideintro["guide:strings"]{the syntax of strings}
@index['("strings" "parsing")]{When} the reader encouters @index['("strings" "parsing")]{When} the reader encouters
@as-index{@litchar{"}}, it begins parsing characters to form a string. The @as-index{@litchar{"}}, it begins parsing characters to form a string. The
string continues until it is terminated by another @litchar{"} (that 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]. constant, the @exnraise[exn:fail:read].
@guideintro["guide:bytestrings"]{the syntax of byte strings}
@index['("byte strings" "parsing")]{A} string constant preceded by @index['("byte strings" "parsing")]{A} string constant preceded by
@litchar{#} is parsed as a byte-string. (That is, @as-index{@litchar{#"}} starts @litchar{#} is parsed as a byte-string. (That is, @as-index{@litchar{#"}} starts
a byte-string literal.) See @secref["mz:bytestrings"] for 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} @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 A @litchar["#\\"] starts a character constant, which has one of the
following forms: following forms:

View File

@ -3,6 +3,8 @@
@title[#:tag "mz:strings"]{Strings} @title[#:tag "mz:strings"]{Strings}
@guideintro["guide:string"]{strings}
A @pidefterm{string} is a fixed-length arary of A @pidefterm{string} is a fixed-length arary of
@seclink["characters"]{characters}. @seclink["characters"]{characters}.