CTAN
Comprehensive TeX Archive Network

Direc­tory tex-archive/macros/texinfo/texinfo/tp/t

$Id: README 6139 2015-02-22 22:53:33Z karl $
texinfo/tp/t/README

  Copyright 2010, 2011, 2012, 2013, 2014, 2015
  Free Software Foundation, Inc.

  Copying and distribution of this README file, with or without
  modification, are permitted in any medium without royalty provided the
  copyright notice and this notice are preserved.

Files anywhere within the texinfo/tp/t/ subdirectory which have no
other copyright notice are hereby placed in the public domain.


These tests are run by "make check" under tp/.  (The test files are 
listed in tp/Makefile.tres, which is a generated file.)  A single .t 
test file can be run on its own with

  perl -w t/03coverage_braces.t

Most test files use a testing infrastructure from t/test_utils.pl.  In
that case the reference output files for the test of a test category 
$test_category.t file are in t/results/$test_category/.  For example, if 
after running "make check" test-suite.log contains a line like:

FAIL: t/03coverage_braces.t 324 - test_image converted html

you can see the difference between the expected and actual output with

  diff t/results/coverage_braces/test_image.pl{,.new}

To review all the differences for one of the *.t test files, you can do:

  for f in t/results/coverage_braces/*.pl; do echo --------; echo \
  Differences in $f; diff $f{,.new}; done | less

The reference files are regenerated with the -g option given to the .t 
file, as in

  perl -w t/03coverage_braces.t -g

To regenerate a specific test reference file, the test name should be 
given as an argument.  For example, to just regenerate the reference 
files for the "test_image" test within t/03.coverage_braces.t, run

  perl -w t/03coverage_braces.t -g test_image

Some tests under this directory use input files in the 'input_files' 
subdirectory.  

For some tests, as well as a .pl file as usual in results/*/, actual
output files are generated.  For those tests, there are directories with
reference test results (with names prefixed with res_), and directories
with the obtained results (with names prefixed with out_).  For example,
many of the tests whose results are in the 'results/indices' directory
follow this format.  (The same convention is used by the test suite in
../tests.)

Tests can be managed using the script in ../maintain/all_tests.sh.  For
example, "./maintain/all_tests.sh generate" regenerates all of the
reference test results (run from the upper-level directory), and
"./maintain/all_tests.sh diff" makes a diff of all resulting files
against references.

From the top directory, you can also create texinfo files corresponding with
tests by running something along the lines of:

  perl -w t/60macro.t -c

to create a file for each of the tests in t/60macro.t, or for a specific
test, here arg_body_expansion_order: 

  perl -w t/60macro.t -c arg_body_expansion_order

The output files will be created with -o, in t/output_files/$test_category/

When adding Perl (sub)tests under t/, also run
maintain/prepare_perl_module_files.sh to regenerate
maintain/MANIFEST_generated_files, or a "plan" (aka results file) will
be missing at distcheck.

Direc­to­ries

Name Notes
in­clude
in­clude_ref­er­ence
init
in­put_files
re­sults

Files

Name Size Date Notes
01use.t 820 2014-04-22 02:00
02cov­er­age.t 12049 2015-02-25 21:17
03cov­er­age_braces.t 6654 2014-11-12 01:00
04verb.t 922 2014-04-22 02:00
05para­graph.t 2440 2015-02-25 21:17
06colum­n­frac­tions.t 1462 2014-04-22 02:00
08misc_com­mands.t 11339 2014-04-22 02:00
09in­dices.t 7966 2014-04-22 02:00
10menu.t 6308 2014-04-22 02:00
16raw.t 5813 2014-04-22 02:00
181quo­ta­tion.t 1841 2014-12-03 01:00
18item­ize.t 7163 2014-04-22 02:00
19def.t 11378 2014-04-22 02:00
20pre­for­mat­ted.t 2652 2015-02-11 10:30
21mul­ti­table.t 4203 2015-02-11 18:01
22xtable.t 3844 2014-04-22 02:00
25re­gions.t 1945 2014-04-22 02:00
27float.t 9178 2014-04-22 02:00
28head­ing.t 786 2014-04-22 02:00
30sec­tion­ing.t 29249 2014-04-22 02:00
50value.t 6341 2014-04-22 02:00
55con­di­tion­als.t 6550 2014-04-22 02:00
57in­valid_nest­ings.t 8626 2014-04-22 02:00
58alias.t 733 2014-04-22 02:00
60macro.t 14284 2014-04-22 02:00
70value_and_macro.t 996 2014-04-22 02:00
80in­clude.t 3729 2014-04-22 02:00
README 3120 2015-02-25 21:17
ac­cents.t 8112 2014-04-22 02:00
au­to­matic_menus.t 2679 2014-04-22 02:00
au­to­matic_nodes.t 5383 2014-04-22 02:00
col­lect_spaces.t 3604 2014-04-22 02:00
con­vert­ers_tests.t 29125 2014-12-03 01:00
do_mas­ter_menu.t 3483 2014-04-22 02:00
doc­book_tests.t 973 2014-04-22 02:00
fix_tex­info.t 1385 2014-04-22 02:00
html_tests.t 6370 2014-05-18 02:00
in­dent_menu_de­scrip­tions.t 1563 2014-04-22 02:00
in­dex_be­fore_item.t 2710 2014-04-22 02:00
info_tests.t 11941 2014-04-22 02:00
lan­guages.t 2618 2014-04-22 02:00
man­ual_tree.pl 3966 2014-04-22 02:00
node­nor­mal­iza­tion.t 6052 2014-04-22 02:00
para­graph.t 25834 2014-04-22 02:00
plain­text_tests.t 18301 2015-02-25 21:17
pro­tect_char­ac­ter_in_tex­info.t 2061 2014-04-22 02:00
ref­er­ence_to_text_in_tree.t 1341 2014-04-22 02:00
test_brace_count.t 2460 2014-04-22 02:00
test_count.t 1618 2014-04-22 02:00
test_fill_gaps_in_sec­tion­ing.t 3113 2014-05-11 02:00
test_is_con­tent_empty.t 1810 2014-05-11 02:00
test_pro­tect_hashchar_at_line_be­gin­ning.t 2899 2014-04-22 02:00
test_sort.t 3279 2014-04-22 02:00
test_tree_copy.t 2027 2014-04-22 02:00
test_utils.pl 40131 2015-02-28 14:51
xml_tests.t 4567 2014-04-22 02:00
Guest Book Sitemap Contact Contact Author