[6451] be slightly clearer about purpose of Makefile.onetst

[Gavin D. Smith]

Revision: 6451
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6451
Author:   gavin
Date:     2015-07-22 16:00:14 +0000 (Wed, 22 Jul 2015)
Log Message:
-----------
be slightly clearer about purpose of Makefile.onetst

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/tp/maintain/regenerate_cmd_tests.sh
    trunk/tp/tests/Makefile.am

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-07-22 15:20:35 UTC (rev 6450)
+++ trunk/ChangeLog     2015-07-22 16:00:14 UTC (rev 6451)
@@ -1,4 +1,11 @@
 2015-07-22  Gavin Smith  <address@hidden>
+
+       * tp/tests/Makefile.am: Give a clue for what "onetst" stands 
+       for, and elaborate on purpose of tests-parser.txt files.
+       * tp/maintain/regenerate_cmd_tests.sh: Say where this file is 
+       run from.  Place some comments in the generated file.
+
+2015-07-22  Gavin Smith  <address@hidden>
        
        * tp/Texinfo/Convert/XSParagraph/mylib: Move all files up a 
        level.

Modified: trunk/tp/maintain/regenerate_cmd_tests.sh
===================================================================
--- trunk/tp/maintain/regenerate_cmd_tests.sh   2015-07-22 15:20:35 UTC (rev 
6450)
+++ trunk/tp/maintain/regenerate_cmd_tests.sh   2015-07-22 16:00:14 UTC (rev 
6451)
@@ -15,6 +15,9 @@
 #
 # Originally written by Patrice Dumas.
 
+# This script is run from "tp/tests/Makefile.am" to regenerate
+# "tp/tests/Makefile.onetst".
+
 #set -x
 
 test_file='tests-parser.txt'
@@ -47,8 +50,10 @@
 (
 cd "$dir/../tests/$destdir" || exit 1
 
-test_driving_files='test_driving_files_generated_list ='
-one_test_files='one_test_files_generated_list = '
+test_driving_files='# List of files that describe tests.  See tp/tests/README.
+test_driving_files_generated_list ='
+one_test_files='# List of test scripts that only run one test
+one_test_files_generated_list = '
 
 gather_tests() {
 type=$1

Modified: trunk/tp/tests/Makefile.am
===================================================================
--- trunk/tp/tests/Makefile.am  2015-07-22 15:20:35 UTC (rev 6450)
+++ trunk/tp/tests/Makefile.am  2015-07-22 16:00:14 UTC (rev 6451)
@@ -1,6 +1,6 @@
 # $Id$
 # Makefile.am for texinfo/tp/tests.
-# Copyright 2012, 2013, 2014 Free Software Foundation, Inc.
+# Copyright 2012, 2013, 2014, 2015 Free Software Foundation, Inc.
 #
 # This file is free software; as a special exception the author gives
 # unlimited permission to copy and/or distribute it, with or without
@@ -10,7 +10,8 @@
 # WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
 # implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 
-# autogenerated test scripts list and tests-parser.txt list
+# autogenerated list of scripts that only run one test, and lists of 
+# tests-parser.txt files specifying the tests to run.
 include $(srcdir)/Makefile.onetst
 
 $(srcdir)/Makefile.onetst: \
@@ -20,6 +21,7 @@
          -base '$(base_tests)' \
          -long '$(long_tests)' \
          -tex_html '$(tex_html_tests)'
+
 #htmlxref htmlxref-only_mono htmlxref-only_split
 base_tests = \
  formatting