diff options
Diffstat (limited to 'Build/source/utils/texi2html/Tests')
-rw-r--r-- | Build/source/utils/texi2html/Tests/Makefile.am | 24 | ||||
-rw-r--r-- | Build/source/utils/texi2html/Tests/Makefile.in | 293 | ||||
-rw-r--r-- | Build/source/utils/texi2html/Tests/README | 112 |
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...). |