diff --git a/pkgs/racket-doc/scribblings/raco/expand.scrbl b/pkgs/racket-doc/scribblings/raco/expand.scrbl index 289d4a6f4a..15baf8fbac 100644 --- a/pkgs/racket-doc/scribblings/raco/expand.scrbl +++ b/pkgs/racket-doc/scribblings/raco/expand.scrbl @@ -6,8 +6,8 @@ @title[#:tag "expand"]{@exec{raco expand}: Macro Expansion} -The @exec{raco expand} command macro expands the contents of -the given source files. Also see @racket[expand]. +The @exec{raco expand} command macro-expands and pretty-prints the +contents of the given source files. See also @racket[expand]. Command-line flags: diff --git a/pkgs/racket-doc/scribblings/raco/raco.scrbl b/pkgs/racket-doc/scribblings/raco/raco.scrbl index 5e5203e5ba..46f65e6110 100644 --- a/pkgs/racket-doc/scribblings/raco/raco.scrbl +++ b/pkgs/racket-doc/scribblings/raco/raco.scrbl @@ -30,6 +30,7 @@ a typical Racket installation. @include-section["test.scrbl"] @include-section["docs.scrbl"] @include-section["expand.scrbl"] +@include-section["read.scrbl"] @include-section["scribble.scrbl"] @include-section["command.scrbl"] @include-section["config.scrbl"] diff --git a/pkgs/racket-doc/scribblings/raco/read.scrbl b/pkgs/racket-doc/scribblings/raco/read.scrbl new file mode 100644 index 0000000000..fccbf9967b --- /dev/null +++ b/pkgs/racket-doc/scribblings/raco/read.scrbl @@ -0,0 +1,26 @@ +#lang scribble/doc +@(require scribble/manual + scribble/bnf + "common.rkt" + (for-label racket/base)) + +@title[#:tag "read"]{@exec{raco read}: Reading and Pretty-Printing} + +@; to associate `history` to the right package: +@(declare-exporting compiler/commands/read) + +The @exec{raco expand} command @racket[read]s and pretty-prints the +contents of the given files. This command is useful for showing +how a @tt{#reader} or @hash-lang[]-based reader extension converts +input to an S-expression. It is also useful for pretty-printing a term +that is already in S-expression form. + +Command-line flags: + +@itemlist[ + @item{@Flag{n} @nonterm{n} or @DFlag{columns} @nonterm{n} --- format output for a display with @nonterm{n} columns} + @item{@Flag{h} or @DFlag{help} --- show help information for this command} + @item{@DFlag{} --- do not treat remaining arguments as switches} +] + +@history[#:added "1.3"] \ No newline at end of file