]> git.eshelyaron.com Git - emacs.git/commitdiff
Document ert test selectors in batch mode (Bug#37476)
authorStefan Kangas <stefankangas@gmail.com>
Sat, 21 Sep 2019 12:58:08 +0000 (14:58 +0200)
committerStefan Kangas <stefankangas@gmail.com>
Sat, 28 Sep 2019 16:04:30 +0000 (18:04 +0200)
* doc/misc/ert.texi (Running Tests in Batch Mode): Document test
selectors.

doc/misc/ert.texi

index 2dbba095d610042650f35afc18a6272b20e1ae9c..889216cbefc433288f3400c6710b056238abd816 100644 (file)
@@ -337,10 +337,14 @@ emacs -batch -l ert -l my-tests.el \
 
 In quiet mode ERT prints only unexpected results and summary.
 
-If ERT is not part of your Emacs distribution, you may need to use
-@code{-L /path/to/ert/} so that Emacs can find it.  You may need
-additional @code{-L} flags to ensure that @code{my-tests.el} and all the
-files that it requires are on your @code{load-path}.
+You can specify selectors to only run a subset of your tests
+(@pxref{Test Selectors}).  For example, the following would run all
+tests where the name of the test matches the string ``to-match''.
+
+@example
+emacs -batch -l ert -l my-tests.el \
+      -eval '(ert-run-tests-batch-and-exit "to-match")'
+@end example
 
 
 @node Test Selectors