bkyk8rc3zvpnsf5inmcqq4n3k98cv6hj-my-site-hyper-literate-git.test.suzanne.soy-0.0.1

commit 6a51476ecddb23fcb5ef03f8bcd07d38cbf4fc19
parent d6bbf9dfe5dfff6218138a9c0994e38d59ad671b
Author: Matthew Flatt <mflatt@racket-lang.org>
Date:   Tue, 17 Aug 2010 17:42:11 -0600

doc clarification

original commit: 4945851df67386945bd1049e1b276b3459354a8c

Diffstat:
M
collects/scribblings/scribble/base.scrbl
 | 
17
+++++++++--------

1 file changed, 9 insertions(+), 8 deletions(-)
diff --git a/collects/scribblings/scribble/base.scrbl b/collects/scribblings/scribble/base.scrbl
@@ -233,12 +233,13 @@ beginning of each line.
 
 The @racket[str]s are @emph{not} decoded with @racket[decode-content],
 so @racket[(verbatim "---")] renders with three hyphens instead of an
-em-dash. Beware, however, that @litchar["@"] for a @racket[verbatim]
-call performs some processing before delivering arguments to
-@racket[verbatim]. The @racket[verbatim] form is typically used with
-@litchar["|{"]...@litchar["}|"] or similar brackets to disable
-@litchar["@"] notation within the @racket[verbatim] argument, like
-this:
+em-dash. Beware, however, that @emph{reading}
+@litchar["@"]@racket[verbatim] converts @litchar["@"] syntax
+within the argument, and such reading occurs well before
+arguments to @racket[verbatim] are delivered at run-time. To disable simple
+@litchar["@"] notation within the @racket[verbatim] argument,
+@racket[verbatim] is typically used with
+@litchar["|{"]...@litchar["}|"] or similar brackets, like this:
 
 @verbatim[#:indent 2]|{
  @verbatim|{
@@ -253,8 +254,8 @@ which renders as
 }|
 
 Even with @litchar["|{"]...@litchar["}|"], beware that consistent
-leading whitespace is removed; see @secref["alt-body-syntax"] for more
-information.
+leading whitespace is removed by the parser; see
+@secref["alt-body-syntax"] for more information.
 
 See also @racket[literal].}