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.
@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

View File

@ -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.

View File

@ -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}

View File

@ -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

View File

@ -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:

View File

@ -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

View File

@ -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.

View File

@ -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).

View File

@ -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

View File

@ -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

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}
@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:

View File

@ -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}.