bug#37476: [PATCH] Document ert test selectors in batch mode

[Michael Albinus <michael.albinus@gmx.de>]

Stefan Kangas <stefan@marxist.se> writes:

Hi Stefan,

sorry to enter this thread such late; somehow I've missed it.

> 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

SELECTOR, if it is a string, is a regular expression. We shall say
so, "... matches the regular expression ...".

> Best regards,
> Stefan Kangas

Best regards, Michael.