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:
parent
9852afe1b1
commit
30e4e812ba
|
@ -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"
|
||||
|
|
|
@ -13,4 +13,4 @@
|
|||
|
||||
(define pkg-authors '(mflatt))
|
||||
|
||||
(define version "1.5")
|
||||
(define version "1.6")
|
||||
|
|
|
@ -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}
|
||||
|
||||
|
|
Loading…
Reference in New Issue
Block a user