From 26eff4c03abed09b10692dad66c794c5407503ce Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Fri, 2 Oct 2015 15:13:06 -0600 Subject: [PATCH] fix `racketblock` docs on `code:comment` and `code:contract` --- scribble-doc/scribblings/scribble/manual.scrbl | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/scribble-doc/scribblings/scribble/manual.scrbl b/scribble-doc/scribblings/scribble/manual.scrbl index ca8272bf..a72d9bad 100644 --- a/scribble-doc/scribblings/scribble/manual.scrbl +++ b/scribble-doc/scribblings/scribble/manual.scrbl @@ -284,20 +284,25 @@ A few other escapes are recognized symbolically: sequence of @racket[_datum]s (i.e., without the @racket[code:line] wrapper).} - @item{@racket[(#,(indexed-racket code:comment) _datum)] typesets like - @racket[_datum], but colored as a comment and prefixed with a - semi-colon. A typical @racket[_datum] escapes from + @item{@racket[(#,(indexed-racket code:comment) _content)] typesets like + @racket[_content], but colored as a comment and prefixed with a + semi-colon. A typical @racket[_content] escapes from Racket-typesetting mode using @racket[unsyntax] and - produces a paragraph using @racket[t]: + produces a string, an element using @racket[elem], + or a paragraph using @racket[t]: @verbatim[#:indent 2]|{ - (code:comment @#,t{this is a comment}) + (code:comment @#,elem{this is a comment}) }| (Note that @litchar|{@#,foo{...}}| reads as @RACKET[(unsyntax (foo "..."))].) } + @item{@racket[(#,(indexed-racket code:contract) _datum ...)] typesets like + the sequence of @racket[_datum]s, but colored as a comment and prefixed with a + semi-colon.} + @item{@as-index[@racketidfont{code:blank}] typesets as a blank space.} @item{@racket[(#,(indexed-racket code:hilite) _datum)] typesets like