summaryrefslogtreecommitdiff
path: root/Build/source/utils/texi2html/Tests
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/utils/texi2html/Tests')
-rw-r--r--Build/source/utils/texi2html/Tests/Makefile.am24
-rw-r--r--Build/source/utils/texi2html/Tests/Makefile.in293
-rw-r--r--Build/source/utils/texi2html/Tests/README112
3 files changed, 429 insertions, 0 deletions
diff --git a/Build/source/utils/texi2html/Tests/Makefile.am b/Build/source/utils/texi2html/Tests/Makefile.am
new file mode 100644
index 00000000000..657754722cc
--- /dev/null
+++ b/Build/source/utils/texi2html/Tests/Makefile.am
@@ -0,0 +1,24 @@
+SUBDIR_TESTS = GermanNodeTest xemacs texinfo sectionning ccvs viper \
+ viper_monolithic texi2html xemacs_frame index_table formatting macros \
+ nodes_texinfo singular floats
+
+
+#check-local:
+# $(srcdir)/test.sh
+
+regenerate:
+ for dir in ${SUBDIR_TESTS}; do \
+ [ -d $${dir}_res ] && cp $$dir/*.passfirst $$dir/*.html $$dir/*.htm $$dir/*.2 $$dir/*.passtexi $${dir}_res;\
+ done
+
+clean-local:
+ for dir in ${SUBDIR_TESTS}; do \
+ (if [ -d $$dir ]; then cd $$dir && $(RM) -- $$dir $$dir-* *.toc *.aux *.log *.op *.cp *.cps \
+ *.fn *.fns *.ky *.kys *.pg *.pgs *.tp *.tps *.vr *.vrs \
+ *.dvi *.html *.htm *.info *.info-? *.info-?? *.info-??? *.html_tempnotag \
+ *.2 *.passfirst *.passtexi \
+ *_?.png *_??.png *_???.png *_l2h_img?.old *_l2h_img??.old *_l2h_img???.old \
+ *_l2h_img?.png *_l2h_img??.png *_l2h_img???.png \
+ *_l2h.tex *_l2h.css *_l2h_images.pl *_l2h_images.tex \
+ *_l2h_labels.pl l2h_cache.pm; fi) ; \
+ done
diff --git a/Build/source/utils/texi2html/Tests/Makefile.in b/Build/source/utils/texi2html/Tests/Makefile.in
new file mode 100644
index 00000000000..3c7cb197344
--- /dev/null
+++ b/Build/source/utils/texi2html/Tests/Makefile.in
@@ -0,0 +1,293 @@
+# Makefile.in generated by automake 1.9.3 from Makefile.am.
+# @configure_input@
+
+# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
+# 2003, 2004 Free Software Foundation, Inc.
+# This Makefile.in is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE.
+
+@SET_MAKE@
+srcdir = @srcdir@
+top_srcdir = @top_srcdir@
+VPATH = @srcdir@
+pkgdatadir = $(datadir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkgincludedir = $(includedir)/@PACKAGE@
+top_builddir = ..
+am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
+INSTALL = @INSTALL@
+install_sh_DATA = $(install_sh) -c -m 644
+install_sh_PROGRAM = $(install_sh) -c
+install_sh_SCRIPT = $(install_sh) -c
+INSTALL_HEADER = $(INSTALL_DATA)
+transform = $(program_transform_name)
+NORMAL_INSTALL = :
+PRE_INSTALL = :
+POST_INSTALL = :
+NORMAL_UNINSTALL = :
+PRE_UNINSTALL = :
+POST_UNINSTALL = :
+build_triplet = @build@
+host_triplet = @host@
+subdir = Tests
+DIST_COMMON = README $(srcdir)/Makefile.am $(srcdir)/Makefile.in
+ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
+am__aclocal_m4_deps = $(top_srcdir)/configure.ac
+am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
+ $(ACLOCAL_M4)
+mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
+CONFIG_CLEAN_FILES =
+SOURCES =
+DIST_SOURCES =
+DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+ACLOCAL = @ACLOCAL@
+AMTAR = @AMTAR@
+AUTOCONF = @AUTOCONF@
+AUTOHEADER = @AUTOHEADER@
+AUTOMAKE = @AUTOMAKE@
+AWK = @AWK@
+CYGPATH_W = @CYGPATH_W@
+DEFS = @DEFS@
+ECHO_C = @ECHO_C@
+ECHO_N = @ECHO_N@
+ECHO_T = @ECHO_T@
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+LIBOBJS = @LIBOBJS@
+LIBS = @LIBS@
+LTLIBOBJS = @LTLIBOBJS@
+MAINT = @MAINT@
+MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@
+MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@
+MAKEINFO = @MAKEINFO@
+PACKAGE = @PACKAGE@
+PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
+PACKAGE_DATE = @PACKAGE_DATE@
+PACKAGE_NAME = @PACKAGE_NAME@
+PACKAGE_STRING = @PACKAGE_STRING@
+PACKAGE_TARNAME = @PACKAGE_TARNAME@
+PACKAGE_VERSION = @PACKAGE_VERSION@
+PATH_SEPARATOR = @PATH_SEPARATOR@
+PERL = @PERL@
+SET_MAKE = @SET_MAKE@
+SHELL = @SHELL@
+STRIP = @STRIP@
+USE_UNICODE = @USE_UNICODE@
+VERSION = @VERSION@
+ac_ct_STRIP = @ac_ct_STRIP@
+am__leading_dot = @am__leading_dot@
+am__tar = @am__tar@
+am__untar = @am__untar@
+bindir = @bindir@
+build = @build@
+build_alias = @build_alias@
+build_cpu = @build_cpu@
+build_os = @build_os@
+build_vendor = @build_vendor@
+datadir = @datadir@
+exec_prefix = @exec_prefix@
+host = @host@
+host_alias = @host_alias@
+host_cpu = @host_cpu@
+host_os = @host_os@
+host_vendor = @host_vendor@
+includedir = @includedir@
+infodir = @infodir@
+install_sh = @install_sh@
+libdir = @libdir@
+libexecdir = @libexecdir@
+localstatedir = @localstatedir@
+mandir = @mandir@
+mkdir_p = @mkdir_p@
+oldincludedir = @oldincludedir@
+prefix = @prefix@
+program_transform_name = @program_transform_name@
+sbindir = @sbindir@
+sharedstatedir = @sharedstatedir@
+sysconfdir = @sysconfdir@
+target_alias = @target_alias@
+SUBDIR_TESTS = GermanNodeTest xemacs texinfo sectionning ccvs viper \
+ viper_monolithic texi2html xemacs_frame index_table formatting macros \
+ nodes_texinfo singular floats
+
+all: all-am
+
+.SUFFIXES:
+$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps)
+ @for dep in $?; do \
+ case '$(am__configure_deps)' in \
+ *$$dep*) \
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \
+ && exit 0; \
+ exit 1;; \
+ esac; \
+ done; \
+ echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu Tests/Makefile'; \
+ cd $(top_srcdir) && \
+ $(AUTOMAKE) --gnu Tests/Makefile
+.PRECIOUS: Makefile
+Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
+ @case '$?' in \
+ *config.status*) \
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
+ *) \
+ echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \
+ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \
+ esac;
+
+$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+
+$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+uninstall-info-am:
+tags: TAGS
+TAGS:
+
+ctags: CTAGS
+CTAGS:
+
+
+distdir: $(DISTFILES)
+ @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \
+ topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \
+ list='$(DISTFILES)'; for file in $$list; do \
+ case $$file in \
+ $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \
+ $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \
+ esac; \
+ if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
+ dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \
+ if test "$$dir" != "$$file" && test "$$dir" != "."; then \
+ dir="/$$dir"; \
+ $(mkdir_p) "$(distdir)$$dir"; \
+ else \
+ dir=''; \
+ fi; \
+ if test -d $$d/$$file; then \
+ if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
+ cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \
+ fi; \
+ cp -pR $$d/$$file $(distdir)$$dir || exit 1; \
+ else \
+ test -f $(distdir)/$$file \
+ || cp -p $$d/$$file $(distdir)/$$file \
+ || exit 1; \
+ fi; \
+ done
+check-am: all-am
+check: check-am
+all-am: Makefile
+installdirs:
+install: install-am
+install-exec: install-exec-am
+install-data: install-data-am
+uninstall: uninstall-am
+
+install-am: all-am
+ @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
+
+installcheck: installcheck-am
+install-strip:
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ `test -z '$(STRIP)' || \
+ echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
+mostlyclean-generic:
+
+clean-generic:
+
+distclean-generic:
+ -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
+
+maintainer-clean-generic:
+ @echo "This command is intended for maintainers to use"
+ @echo "it deletes files that may require special tools to rebuild."
+clean: clean-am
+
+clean-am: clean-generic clean-local mostlyclean-am
+
+distclean: distclean-am
+ -rm -f Makefile
+distclean-am: clean-am distclean-generic
+
+dvi: dvi-am
+
+dvi-am:
+
+html: html-am
+
+info: info-am
+
+info-am:
+
+install-data-am:
+
+install-exec-am:
+
+install-info: install-info-am
+
+install-man:
+
+installcheck-am:
+
+maintainer-clean: maintainer-clean-am
+ -rm -f Makefile
+maintainer-clean-am: distclean-am maintainer-clean-generic
+
+mostlyclean: mostlyclean-am
+
+mostlyclean-am: mostlyclean-generic
+
+pdf: pdf-am
+
+pdf-am:
+
+ps: ps-am
+
+ps-am:
+
+uninstall-am: uninstall-info-am
+
+.PHONY: all all-am check check-am clean clean-generic clean-local \
+ distclean distclean-generic distdir dvi dvi-am html html-am \
+ info info-am install install-am install-data install-data-am \
+ install-exec install-exec-am install-info install-info-am \
+ install-man install-strip installcheck installcheck-am \
+ installdirs maintainer-clean maintainer-clean-generic \
+ mostlyclean mostlyclean-generic pdf pdf-am ps ps-am uninstall \
+ uninstall-am uninstall-info-am
+
+
+#check-local:
+# $(srcdir)/test.sh
+
+regenerate:
+ for dir in ${SUBDIR_TESTS}; do \
+ [ -d $${dir}_res ] && cp $$dir/*.passfirst $$dir/*.html $$dir/*.htm $$dir/*.2 $$dir/*.passtexi $${dir}_res;\
+ done
+
+clean-local:
+ for dir in ${SUBDIR_TESTS}; do \
+ (if [ -d $$dir ]; then cd $$dir && $(RM) -- $$dir $$dir-* *.toc *.aux *.log *.op *.cp *.cps \
+ *.fn *.fns *.ky *.kys *.pg *.pgs *.tp *.tps *.vr *.vrs \
+ *.dvi *.html *.htm *.info *.info-? *.info-?? *.info-??? *.html_tempnotag \
+ *.2 *.passfirst *.passtexi \
+ *_?.png *_??.png *_???.png *_l2h_img?.old *_l2h_img??.old *_l2h_img???.old \
+ *_l2h_img?.png *_l2h_img??.png *_l2h_img???.png \
+ *_l2h.tex *_l2h.css *_l2h_images.pl *_l2h_images.tex \
+ *_l2h_labels.pl l2h_cache.pm; fi) ; \
+ done
+# Tell versions [3.59,3.63) of GNU make to not export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:
diff --git a/Build/source/utils/texi2html/Tests/README b/Build/source/utils/texi2html/Tests/README
new file mode 100644
index 00000000000..2a34ac5171e
--- /dev/null
+++ b/Build/source/utils/texi2html/Tests/README
@@ -0,0 +1,112 @@
+Running the tests and understanding the results
+-----------------------------------------------
+
+To run all the tests just do
+$ ./test.sh
+
+For each test the output begins with the line:
+making test: dir/file options...
+
+dir is the dir where the test is made, file is the texinfo file processed and
+the optional options are the options passed to texi2html when doing the test.
+Then the test results are outputted. There are 5 type of results outputed:
+
+status -> always
+stderr line count -> always
+diffs -> optionnal
+test with tidy -> optionnal
+test validity -> optionnal
+
+For each of these, the type is outputted indented. The results appear on
+lines below, more indented. When the test fails there is !!! on the line.
+For example:
+
+making test: formatting/not_closed_in_menu.texi
+ status:
+ passed
+ stderr line count:
+ !!! bad line count: 7 != 0
+
+I now turn the the individual result type:
+
+* status
+The exit status of the command is tested for success or failure.
+
+* stderr line count
+The number of stderr lines is compared against a reference.
+
+* diffs
+out files are diffed against reference files present in dir_res. A '.'
+means a successfull comparison. If there are more than one test in that
+dir, there might be files differing or files not found if the files
+haven't allready been regenerated.
+
+* test with tidy
+tidy is run on resulting html files.
+
+* test validity
+validate is run on resulting html files.
+
+
+Adding a test
+-------------
+
+To add a test, you have to add a line in test.sh, near the end.
+Here is the syntax:
+
+test_texi dir file "option1 option2" stderr_lines suffix basename ignore_tags validate test_tidy fail
+
+dir is the only mandatory argument. There are defaults for the other
+arguments when not given. However if you want to specify, say, basename
+and use the defaults for the preceding ones, you have to set them
+explicitely.
+
+dir: the directory where the files are.
+file: the texinfo file. If not present dir.texi is used
+"option1 option2": options passed to texi2html. Default is no option
+stderr_lines: number of lines of stderr. Default is 0
+suffix: suffix of the file, used to find the basename. 'texi' is assumed
+basename: basename of the generated files. The basename of file is the default
+ignore_tags: if set to 'ignore_tags' or 'yes' rcs tags are ignored
+validate: if unset or set to 'validate' validation is tried
+test_tidy: if unset or set to 'tidy' or 'test_tidy', tidy is tried
+fail: if unset or set to 'success' the exit code should be 0
+
+* Simple example:
+test_texi macros
+
+test macros.texi in the macros dir, without options, assuming generated
+files beginning with macros.
+
+* Complex example:
+test_texi sectionning no_node.texi "-prefix chapter_split_no_node -split chapter" 0 texi chapter_split_no_node
+
+Test no_node.texi in the sectionning dir, with the options:
+-prefix chapter_split_no_node -split chapter
+no lines on stderr, suffix is texi and basename for generated files is
+chapter_split_no_node (which matches the option -prefix chapter_split_no_node).
+
+Remarks:
+The stderr output is in basename.2, the result of the first pass in
+basename.passtexi, of the second pass in basename.passfirst.
+the -test option is always passed.
+To run a single test you can run test.sh with the arguments you would have
+passed to test_texi. For example
+
+$./test.sh viper viper.texi "-split chapter"
+
+will run a test for viper.texi in the viper directory with option
+-split chapter
+
+
+Regenerating tests
+------------------
+
+make regenerate copy all the *.html, *.2, *.passtexi and *.passfirst from
+the test directories to the result directories (test directory with _res
+appended).
+This is usefull when the new result is the good result and you want to
+avoid manually copying the good files to the result directory.
+
+To add a new test directory add it to the SUBDIR_TESTS variable in
+Makefile.am (and rerun automake, autoconf...).