[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo/texi2html/test README base_tests long_t...
From: |
Karl Berry |
Subject: |
texinfo/texi2html/test README base_tests long_t... |
Date: |
Wed, 21 Jul 2010 00:23:00 +0000 |
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=.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- texinfo/texi2html/test README base_tests long_t...,
Karl Berry <=