texinfo/texi2html/test README base_tests long_t...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/07/21 00:23:00

Modified files:
        texi2html/test : README base_tests long_tests run_test.sh 
                         run_test_all.sh tests.sh 

Log message:
        copyright notices, doc tweak

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/texi2html/test/README?cvsroot=texinfo&r1=1.7&r2=1.8
http://cvs.savannah.gnu.org/viewcvs/texinfo/texi2html/test/base_tests?cvsroot=texinfo&r1=1.4&r2=1.5
http://cvs.savannah.gnu.org/viewcvs/texinfo/texi2html/test/long_tests?cvsroot=texinfo&r1=1.1&r2=1.2
http://cvs.savannah.gnu.org/viewcvs/texinfo/texi2html/test/run_test.sh?cvsroot=texinfo&r1=1.29&r2=1.30
http://cvs.savannah.gnu.org/viewcvs/texinfo/texi2html/test/run_test_all.sh?cvsroot=texinfo&r1=1.18&r2=1.19
http://cvs.savannah.gnu.org/viewcvs/texinfo/texi2html/test/tests.sh?cvsroot=texinfo&r1=1.2&r2=1.3

Patches:
Index: README
===================================================================
RCS file: /sources/texinfo/texinfo/texi2html/test/README,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- README      19 Jul 2010 23:48:20 -0000      1.7
+++ README      21 Jul 2010 00:23:00 -0000      1.8
@@ -1,6 +1,14 @@
+texinfo/texi2html/tests/README
+
+  Copyright (C) 2010 Free Software Foundation, Inc.
+
+  Copying and distribution of this file, with or without modification,
+  are permitted in any medium without royalty provided the copyright
+  notice and this notice are preserved.
+
+
 Prerequisites
 =============
-
 To run this testsuite, sed (with -i), awk, diff, mktemp are used. To 
 find the same results, tex4ht, latex2HTML, html2wiki, perl with unicode 
 support and the Text::Unidecode perl module have to be installed (with their 
@@ -12,7 +20,6 @@
 
 Running the testsuite
 =====================
-
 This testsuite can be run 
 
 * using the makefile rules: check for the base tests, long-check for 
@@ -29,6 +36,7 @@
 * by going in one directory and running one specific test, like
 $ cd formatting
 $ ../run_test_all.sh quotes
+(see below for info on how test names are specified).
 
 The test results are in the out directories; the reference results are
 in res directories; there are 3 out and res directories, out/ and res/
@@ -45,8 +53,8 @@
 is printed.
 
 If a whole directory check run using './tests.sh all' had no failure, 
-the directory name is printed followed by a 0, it is followed 
-by a 1 if there was some failure.
+the directory name is printed followed by a 0; it is followed 
+by a 1 if there was a failure.
 
 The test results are in a directory below the out directories. This 
 directory name can be considered as the test name. Let's call it a_test
@@ -61,21 +69,20 @@
 
 Tests specification
 ===================
+Test runs are driven by the content of the tests.txt file. It is a line
+oriented file. A # starts a comment. Each line describes a test.  The
+first word on the line is the test name which corresponds also with the
+resulting directory (what we called a_test above).  It is followed by
+the source manual name. The source manual name has to have the .texi
+extension. Optionnally additional arguments can be given on the
+remaining of the line.
 
-The tests ran are driven by the content of the tests.txt file. It is a 
-line oriented file. A # starts a comment. Each line describes a test. 
-The first word on the line is the test name which corresponds also with 
-the resulting directory (we called it a_test in the previous examples). 
-It is followed by the source manual name. The source manual name has to 
-have the .texi extension. Optionnally additional arguments can be given 
-on the remaining of the line.
-
-So, for example
+So, for example, the line
 
 a_test manual.texi
 
 specifies that for the a_test test, the file manual.texi is processed and
-results are put are put in the a_test directory.
+results are put are put in the a_test directory.  The line:
 
 a_test_split_chapter manual.texi --split chapter
 
@@ -83,9 +90,9 @@
 command line arguments --split chapter will be in the a_test_split_chapter
 directory.
 
-Using 'texi' as the test name is special. In that case the directory name 
+Using "texi" as the test name is special. In that case the directory name 
 is constructed by appending _ followed by the manual name without the .texi
-extension to 'texi'. And the result is not processed normally, but instead
+extension to "texi". And the result is not processed normally, but instead
 macros are expanded and regions that are not processed removed and the 
 result is put in a file with the same name than the manual. Similar result 
 files but with include file, macro and line number informations are put in 
@@ -94,24 +101,26 @@
 pass and the .passfirst file corresponds with the result after the second 
 pass.
 
-So, for example, if 
+So, for example, the tests.txt line 
 
 texi manual.texi
 
-appears in the tests.txt file, in the directory out/texi_manual the file 
-manual.texi will have macros expanded and ignored regions removed, and the
-files manual.passtexi and manual.passfirst will contain the additionaly
-include file and line number informations corresponding with the texinfo
-at the end of the first and second pass.
+results in the following: in the directory out/texi_manual the file
+manual.texi will have macros expanded and ignored regions removed, and
+the files manual.passtexi and manual.passfirst will contain the
+additional include file and line number informations corresponding with
+the texinfo at the end of the first and second pass.
 
 
-Misc
-====
-
+LaTeX2html
+==========
 For the tests that use latex2html, to avoid the test failing if there is 
 a dot in the cwd, mktemp is used to create a temporary directory, hopefully
 in /tmp, and the directory is passed through on the command line.
 
+
+Common .texi
+============
 A common .texi file should be in the top-level directory (there is such an
 example with coverage_macro.texi). Currently there is no support for common
 init file, but it could be added easily.

Index: base_tests
===================================================================
RCS file: /sources/texinfo/texinfo/texi2html/test/base_tests,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- base_tests  19 Jul 2010 23:48:20 -0000      1.4
+++ base_tests  21 Jul 2010 00:23:00 -0000      1.5
@@ -1,4 +1,9 @@
 #! /bin/sh
+# Copyright (C) 2010 Free Software Foundation, Inc.
+#
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.
 
 if [ z"$srcdir" = 'z' ]; then
   srcdir=.

Index: long_tests
===================================================================
RCS file: /sources/texinfo/texinfo/texi2html/test/long_tests,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- long_tests  18 Aug 2008 18:01:50 -0000      1.1
+++ long_tests  21 Jul 2010 00:23:00 -0000      1.2
@@ -1,4 +1,9 @@
 #! /bin/sh
+# Copyright (C) 2010 Free Software Foundation, Inc.
+#
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.
 
 if [ z"$srcdir" = 'z' ]; then
   srcdir=.

Index: run_test.sh
===================================================================
RCS file: /sources/texinfo/texinfo/texi2html/test/run_test.sh,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -b -r1.29 -r1.30
--- run_test.sh 14 Jul 2010 15:42:35 -0000      1.29
+++ run_test.sh 21 Jul 2010 00:23:00 -0000      1.30
@@ -1,4 +1,9 @@
 #! /bin/sh
+# Copyright (C) 2010 Free Software Foundation, Inc.
+#
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.
 
 #set -x
 

Index: run_test_all.sh
===================================================================
RCS file: /sources/texinfo/texinfo/texi2html/test/run_test_all.sh,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -b -r1.18 -r1.19
--- run_test_all.sh     17 Jul 2010 00:11:38 -0000      1.18
+++ run_test_all.sh     21 Jul 2010 00:23:00 -0000      1.19
@@ -1,4 +1,9 @@
 #! /bin/sh
+# Copyright (C) 2010 Free Software Foundation, Inc.
+#
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.
 
 #set -x
 

Index: tests.sh
===================================================================
RCS file: /sources/texinfo/texinfo/texi2html/test/tests.sh,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- tests.sh    21 Jun 2009 09:25:39 -0000      1.2
+++ tests.sh    21 Jul 2010 00:23:00 -0000      1.3
@@ -1,4 +1,9 @@
 #! /bin/sh
+# Copyright (C) 2010 Free Software Foundation, Inc.
+#
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.
 
 if [ z"$srcdir" = 'z' ]; then
   srcdir=.