Subject: Document new ERT function ert-summarize-tests-batch-and-exit

From: Shakthi Kannan <[email-masked]>
Date: Fri, 25 Dec 2015 21:59:44 +0530

$subject

-- 
Shakthi Kannan
http://www.shakthimaan.com
From a53e3f74d3b7017c253b869eab91f0398aba8dc0 Mon Sep 17 00:00:00 2001
From: Shakthi Kannan <[email-masked]>
Date: Fri, 25 Dec 2015 21:47:49 +0530
Subject: [PATCH] Document new ERT function ert-summarize-tests-batch-and-exit

---
 doc/misc/ert.texi | 9 +++++++++
 etc/NEWS          | 4 ++++
 2 files changed, 13 insertions(+)

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 @@ Running Tests in Batch Mode
 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
+@file{output.log}, and use the
+@code{ert-summarize-tests-batch-and-exit} function to produce a neat
+summary as shown below:
+
+@example
+emacs -batch -l ert -f ert-summarize-tests-batch-and-exit output.log
+@end 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'.
 
-- 
2.1.4