[Emacs-diffs] emacs-25 406d132: Document 'ert-summarize-tests-batch-and-exit'

[Eli Zaretskii]

branch: emacs-25
commit 406d132244867fe079580fa003c9dac88063283e
Author: Shakthi Kannan <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Document 'ert-summarize-tests-batch-and-exit'
    
    * doc/misc/ert.texi (Running Tests in Batch Mode): Document
    'ert-summarize-tests-batch-and-exit'.
---
 doc/misc/ert.texi |    9 +++++++++
 etc/NEWS          |    4 ++++
 2 files changed, 13 insertions(+), 0 deletions(-)

diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi
index 35d315c..c236323 100644
--- a/doc/misc/ert.texi
+++ b/doc/misc/ert.texi
@@ -283,6 +283,15 @@ with a zero exit status if all tests passed, or nonzero if 
any tests
 failed or if anything else went wrong.  It will also print progress
 messages and error diagnostics to standard output.
 
+You can also redirect the above output to a log file, say
address@hidden, and use the
address@hidden function to produce a neat
+summary as shown below:
+
address@hidden
+emacs -batch -l ert -f ert-summarize-tests-batch-and-exit output.log
address@hidden example
+
 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
diff --git a/etc/NEWS b/etc/NEWS
index 19c9858..f1ba79f 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -696,7 +696,11 @@ The remainder were:
 
 **** The nil and list forms of `diary-display-function'.
 
++++
 ** New ERT function `ert-summarize-tests-batch-and-exit'.
+If the output of ERT tests in batch mode execution can be saved to a
+log file, then it can be passed as an argument to the above function
+to produce a neat summary.
 
 ** New js.el option `js-indent-first-init'.