From ca8dad126c88f68a3b5fcb59345905edb73e7d21 Mon Sep 17 00:00:00 2001 From: John Clements Date: Mon, 23 Mar 2015 21:14:46 -0700 Subject: [PATCH] add docs on not running tests --- pkgs/racket-doc/scribblings/raco/test.scrbl | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/pkgs/racket-doc/scribblings/raco/test.scrbl b/pkgs/racket-doc/scribblings/raco/test.scrbl index f7504d7fce..bb2939404c 100644 --- a/pkgs/racket-doc/scribblings/raco/test.scrbl +++ b/pkgs/racket-doc/scribblings/raco/test.scrbl @@ -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}}