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

[Lars Ingebrigtsen]

Stefan Kangas <stefan@marxist.se> writes:

> I think it would be good to document how to use test selectors on the
> ert manual page that talks about running tests in batch mode.  I came
> up with the following suggested patch.
>
> Any comments?

[...]

> -If ERT is not part of your Emacs distribution, you may need to use
> +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

I guess that would be nice to have documented, but it's not a use case
I've ever had.  Tests are usually grouped in separate files, so you'd
usually have (as in Emacs) "make foo-tests" or whatever in your
Makefiles.

> +If you are using a version of Emacs older than 24.1, ERT is not part
> +of your Emacs distribution.  In this case, you may need to use

The Emacs manuals usually document what's currently in Emacs, so it's a
bit odd to be talking about Emacs 24.1 here, isn't it?  So perhaps that
paragraph should just be removed?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no