raco test: doc and help tweaks

* Clarify shell context for `++args` note on quotes

 * Add `history` notes

 * Make the help output fit in 80 columns

 * Bump "compiler-lib" version
This commit is contained in:
Matthew Flatt 2017-06-22 08:21:46 -06:00
parent 9852afe1b1
commit 30e4e812ba
3 changed files with 15 additions and 12 deletions

View File

@ -1006,14 +1006,14 @@
(set! default-mode 'process))]
#:multi
[("--submodule" "-s") name
"Runs submodule <name>\n (defaults to running just the `test' submodule)"
"Runs submodule <name>\n (defaults to running just the `test` submodule)"
(let ([n (string->symbol name)])
(set! submodules (cons n submodules)))]
[("++arg") arg
"Adds <arg> to `current-command-line-arguments`"
"Adds <arg> to the end of `current-command-line-arguments`"
(set! extra-command-line-args (cons arg extra-command-line-args))]
[("++args") args
"Adds <args> (whitespace-separated values) to `current-command-line-arguments`"
[("++args") args
"Adds each whitespace-delimited in <args> like ++arg"
(set! extra-command-line-args
(append (reverse (string-split args)) extra-command-line-args))]
#:once-any
@ -1061,12 +1061,12 @@
(set! check-stderr? #t)]
#:multi
[("++ignore-stderr") pattern
"Ignore standard error output if it matches #px\"<pattern>\""
"Ignore stderr output that matches #px\"<pattern>\""
(set! ignore-stderr-patterns
(cons (pregexp pattern) ignore-stderr-patterns))]
#:once-each
[("--quiet" "-q")
"Suppress `raco test: ...' message"
"Suppress `raco test: ...` message"
(set! quiet? #t)]
[("--heartbeat")
"Periodically report that a test is still running"

View File

@ -13,4 +13,4 @@
(define pkg-authors '(mflatt))
(define version "1.5")
(define version "1.6")

View File

@ -164,23 +164,26 @@ The @exec{raco test} command accepts several flags:
counts based on the log.}
@item{@DPFlag{arg} @nonterm{argument}
--- Forwards @nonterm{argument} to the invoked test module,
--- Adds @nonterm{argument} to the list of arguments to the invoked test module,
so that the invoked module sees @nonterm{argument} in its
@racket[current-command-line-arguments]. These arguments are
combined with any arguments specified in @filepath{info.rkt}
by @racket[test-command-line-arguments].}
@item{@DPFlag{args} @nonterm{arguments}
--- The same as @DPFlag{arg}, except that {arguments} is treated
as a whitespace-separated list of arguments to forward. To specify
multiple arguments using this flag, @nonterm{arguments} must be
--- The same as @DPFlag{arg}, but @nonterm{arguments} is treated
as a whitespace-delimited list of arguments to add. To specify
multiple arguments using this flag within a typical shell,
@nonterm{arguments} must be
enclosed in quotation marks.
}
]
@history[#:changed "1.1" @elem{Added @DFlag{heartbeat}.}
#:changed "1.4" @elem{Changed recognition of module suffixes to use @racket[get-module-suffixes],
which implies recognizing @filepath{.ss} and @filepath{.rkt}.}]
which implies recognizing @filepath{.ss} and @filepath{.rkt}.}
#:changed "1.5" @elem{Added @DPFlag{ignore-stderr}.}
#:changed "1.6" @elem{Added @DPFlag{arg} and @DPFlag{args}.}]
@section[#:tag "test-config"]{Test Configuration by Submodule}