[groff] 30/50: INSTALL.extra: Add test suite usage advice.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 2d090cf7a0212d2fc75e5cc6b5333186e8fd28c2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu May 19 09:59:40 2022 -0500

    INSTALL.extra: Add test suite usage advice.
    
    * INSTALL.extra (In Case of Trouble): Add advice on using the test
      suite, particularly if it fails.
    
    Fixes <https://savannah.gnu.org/bugs/?62478> (one hopes).
---
 ChangeLog     |  7 +++++++
 INSTALL.extra | 30 ++++++++++++++++++++++++++----
 2 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 4c07e63a..10e7596c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2022-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * INSTALL.extra (In Case of Trouble): Add advice on using the
+       test suite, particularly if it fails.
+
+       Fixes <https://savannah.gnu.org/bugs/?62478> (one hopes).
+
 2022-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * doc/groff.texi (Input Line Traps):  Expand discussion.  The
diff --git a/INSTALL.extra b/INSTALL.extra
index c15ff885..4c436224 100644
--- a/INSTALL.extra
+++ b/INSTALL.extra
@@ -189,10 +189,32 @@ groff's Texinfo manual if you make changes.  A working 
TeX installation
 In Case of Trouble
 ==================
 
-If you have problems, read the PROBLEMS file.  If this doesn't help
-and you need support, please contact the groff mailing list at
-groff@gnu.org.  If you think that you have found a bug, please submit a
-report to our bug tracker.
+If a test fails, gather its log file from the build directory.  For
+instance, the test "tmac/tests/localization-works.sh" (in the source
+directory) will have a log file called
+"tmac/tests/localization-works.sh.log" in the build directory.
+
+To re-run a test, change to the top of the build directory (if
+necessary) and run the test by name from the shell prompt.
+
+For example, to rerun the test mentioned above from a "build" directory
+I created as a subdirectory in the source tree, I would do this.
+
+  (cd build && ../tmac/tests/localization-works.sh)
+
+I can view the test log as follows.
+
+  cat build/tmac/tests/localization-works.sh.log
+
+Many known issues are documented in the PROBLEMS file; some apply to
+historical systems.  You can browse groff bug reports via the GNU
+Savannah issue tracker.
+
+  https://savannah.gnu.org/bugs/?group=groff
+
+If that doesn't help and you need support, please contact the groff
+mailing list at groff@gnu.org.  If you think that you have found a bug,
+please submit a ticket.
 
   https://savannah.gnu.org/bugs/?group=groff&func=additem