add docs on not running tests

This commit is contained in:
John Clements 2015-03-23 21:14:46 -07:00
parent 785fb57dc1
commit ca8dad126c

View File

@ -11,7 +11,7 @@
The @exec{raco test} command requires and runs the (by default)
@racket[test] submodule associated with each path given on the command
line. Command-line flag can control which submodule is run, whether to
line. Command-line flags can control which submodule is run, whether to
run the main module if no submodule is found, and whether to run tests
directly, in separate processes (the default), or in separate places.
The current directory is set to a test file's directory before running
@ -185,6 +185,22 @@ identifiers:
]
In order to prevent evaluation of a file for testing purposes, it
suffices to create a submodule that does not perform any tests and
does not trigger the evaluation of the enclosing module. The
@racket[module*] form is one way to accomplish this:
@#reader scribble/comment-reader
(racketmod
racket
(/ 1 0)
;; don't run this file for testing:
(module* test racket
;; no tests!
13)
)
@section[#:tag "test-config-info"]{Test Configuration by @filepath{info.rkt}}