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

commit 176a0623d9bc706f992bf87ef6d7afefe9864f08
parent 6113f07feac71eb9d36a0b9a1caa60646f4012a4
Author: Eli Barzilay <eli@racket-lang.org>
Date:   Wed, 20 Jun 2007 00:56:26 +0000

checkpoint

svn: r6702

original commit: 513726af9e048c94da74724b89c8868c2663c433

Diffstat:
M
collects/scribble/doc.txt
 | 
16
+++++++++-------

1 file changed, 9 insertions(+), 7 deletions(-)
diff --git a/collects/scribble/doc.txt b/collects/scribble/doc.txt
@@ -83,8 +83,8 @@ string for each end of line.  For example:
        blah}
 
 It is your responsibility to make sure that `foo' is bound (in any way:
-it can be either a function or a macro).  To see the forms, you can use
-quote as usual, for example:
+it can be either a function or a macro, or in quoted forms).  To see the
+forms, you can use quote as usual, for example:
 
   '@foo{bar}
 
@@ -97,8 +97,9 @@ wrapping the *whole* expression.  For example:
 
 When writing Scheme code, this means that @`',@foo{blah} is exactly the
 same as `@',@foo{blah} and `',@@foo{blah}, but unlike the latter two,
-the first construct can appear in body texts with the same meaning,
-whereas the other two would not work (see below).
+the first construct can appear in @-body texts with the same meaning,
+whereas the other two would not work (the punctuations will be taken as
+part of the text).
 
 The command itself is not limited to a Scheme identifier -- it can be
 any Scheme expression:
@@ -120,14 +121,15 @@ and the ";"), then the construct is a comment.  There are two comment
 forms, one for arbitrary-text and possibly nested comments, and another
 one for a -to-the-end-of-the-line comment:
 
-  @; <whitespace>* { ...any-text-including-newlines... }
+  @;{ ...any-text-including-tested-scribble-pieces... }
 
   @; <anything-that-doesn't-begin-with-a-brace-to-the-end-of-the-line>
 
 Note that the first form is analogous to a "#;" comment: the commented
 body must still parse correctly.  Also note that in the second form all
-text from the "@;" to the end of the line an all following (non-newline)
-whitespaces are part of the comment.  For example:
+text from the "@;" to the end of the line and all following
+(non-newline) whitespaces are part of the comment (as with TeX `%'
+comments).  For example:
 
   @foo{bar @; comment    --is-read-as-->    (foo "bar baz")
        baz}