From cc7f2fb0cc1c077d0648e48d0d9efb713c375abe Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Sat, 21 Sep 2019 14:58:08 +0200 Subject: [PATCH] Document ert test selectors in batch mode (Bug#37476) * doc/misc/ert.texi (Running Tests in Batch Mode): Document test selectors. --- doc/misc/ert.texi | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi index 2dbba095d6..889216cbef 100644 --- a/doc/misc/ert.texi +++ b/doc/misc/ert.texi @@ -337,10 +337,14 @@ Running Tests in Batch Mode 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 -- 2.20.1