branch master updated: Move content to a specific section on manual tests in tp/TODO

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 88dd1a441d Move content to a specific section on manual tests in 
tp/TODO
88dd1a441d is described below

commit 88dd1a441ddf89dc76d09b5540737a22c2a55118
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Sat Mar 5 23:18:34 2022 +0100

    Move content to a specific section on manual tests in tp/TODO
---
 tp/TODO | 277 ++++++++++++++++++++++++++++++++++++----------------------------
 1 file changed, 154 insertions(+), 123 deletions(-)

diff --git a/tp/TODO b/tp/TODO
index 4eb7e14e85..3f7479ea8e 100644
--- a/tp/TODO
+++ b/tp/TODO
@@ -30,129 +30,6 @@ bytes.  To check that they can never be upgraded + document
  INTERNAL_LINKS
 
 
-Tests in non utf8 locale (in practice tested in latin1 locale)
-
-Tests with correct or acceptable results
-
-t/formats_encodings.t manual_simple_utf8_with_error
-utf8 manual with errors involving non ascii strings
-./texi2any.pl ./t/input_files/manual_simple_utf8_with_error.texi
-
-t/formats_encodings.t manual_simple_latin1_with_error
-latin1 manual with errors involving non ascii strings
-./texi2any.pl ./t/input_files/manual_simple_latin1_with_error.texi
-
-tests/formatting cpp_lines
-CPP directive with non ascii characters, utf8 manual
-./texi2any.pl -I ./t/include/ ./t/input_files/cpp_lines.texi
-accentêd:7: warning: làng is not a valid language code
-The file is UTF-8 encoded, the @documentencoding is obeyed which leads
-in the Parser, to an UTF-8 encoding of include file name, and not to the latin1
-encoding which should be used for the output messages encoding.
-This output is by (Gavin) design.
-
-many_input_files/output_dir_file_non_ascii.sh
-non ascii output directory, utf8 manual
-./texi2any.pl -o encodé/ ./t/input_files/simplest.texi
-
-test of non ascii included file name in utf8 locale is already in formatting:
-formatting/osé_utf8.texi:@include included_akçentêd.texi
-./texi2any.pl --force -I tests/ tests/formatting/os*_utf8.texi
-The file name is utf-8 encoded in messages, which is expected as we do not
-decode/encode file names from the command line for messages
-osé_utf8.texi:15: warning: undefined flag: vùr
-
-t/80include.t cpp_line_latin1
-CPP directive with non ascii characters, latin1 manual
-./texi2any.pl --force ./t/input_files/cpp_line_latin1.texi
-
-Issue to add 'tests/included_lat'$'\356''n1.texi' in make dist
-tests/other manual_include_accented_file_name_latin1
-./texi2any.pl --force -I tests/ 
tests/other/manual_include_accented_file_name_latin1.texi
-
-latin1 encoded and latex2html in latin1 locale
-./texi2any.pl --html --init init/latex2html.pm 
tests/tex_html/tex_encode_latin1.texi
-
-latin1 encoded and tex4ht in latin1 locale
-./texi2any.pl --html --init init/tex4ht.pm 
tests/tex_html/tex_encode_latin1.texi
-
-./texi2any.pl --html --init init/tex4ht.pm tex_encodé_latin1.texi
-Firefox can't find tex_encod%uFFFD_latin1_html/Chapter.html (?)
-Opened from within the directory, still can't find the image file:
-tex_encod%E9_latin1_html/tex_encod%C3%A9_latin1_tex4ht_tex0x.png
-The file names and file contents looks right, though, with latin1 only
-encoded characters.
-
-epub for utf8 encoded manual in latin1 locale
-./texi2any.pl --force -I tests/ --init init/epub3.pm 
tests/formatting/os*_utf8.texi
-
-epub for latin1 encoded manual in latin1 locale
-cp tests/tex_html/tex_encode_latin1.texi tex_encodé_latin1.texi
-./texi2any.pl --init init/epub3.pm tex_encodé_latin1.texi
-
-./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext 
tests/formatting/os*_utf8.texi
-output file name is in latin1, but the encoding inside is utf8 consistent
-with the document encoding.
-
-./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext 
tests/formatting/os*_utf8_no_setfilename.texi
-output file name is utf8 because the utf8 encoded input file name
-is decoded using the locale latin1 encoding keeping the 8bit characters
-from the utf8 encoding, and the encoding inside is utf8
-consistent with the document encoding.
-
-./texi2any.pl --force -I tests/ -o encodé/raw.txt -c 
TEXINFO_OUTPUT_FORMAT=rawtext tests/formatting/os*_utf8.texi
-encodé/raw.txt encoded in latin1, and the encoding inside is utf8
-consistent with the document encoding.
-
-./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext -c 
'SUBDIR=subdîr' tests/formatting/os*_utf8.texi
-subdîr/osé_utf8.txt encoded in latin1, and the encoding inside is utf8
-consistent with the document encoding.
-
-Tests with incorrect results, though not bugs
-
-utf8 encoded manual name and latex2html in latin1 locale
-./texi2any.pl --html --init init/latex2html.pm 
tests/tex_html/tex_encod*_utf8.texi
- -> the input file name is decoded using DATA_INPUT_ENCODING_NAME
-    which is set to ISO-8859-1, although the file name is in utf8.
-./texi2any.pl -c 'DATA_INPUT_ENCODING_NAME utf-8' -c 'L2H_CLEAN 0' --html 
--init init/latex2html.pm tests/tex_html/tex_encod*_utf8.texi
-Errors out with
-utf8 "\xE9" does not map to Unicode at ./init/latex2html.pm line 515, 
<L2H_HTML> line 6.
-which corresponds to tex_encodé_utf8_html/tex_encodé_utf8_l2h.html
-<TITLE>tex_encodé_utf8_l2h</TITLE>, with the é encoded in latin1.
-Probably latex2html outputs the latin1 file names as it gets from the command
-line binary encoded.  There are also utf8 encoded characters in the file.
-
-latin1 encoded manual name and latex2html in latin1 locale
-cp tests/tex_html/tex_encode_latin1.texi tex_encodé_latin1.texi
-./texi2any.pl -c 'L2H_CLEAN 0' --html --init init/latex2html.pm 
tex_encodé_latin1.texi
-Errors out with
-utf8 "\xE9" does not map to Unicode at ./init/latex2html.pm line 515, 
<L2H_HTML> line 6.
-which corresponds to tex_encodé_latin1_html/tex_encodé_latin1_l2h.html
-<TITLE>tex_encodé_latin1_l2h</TITLE> with the é encoded in latin1.
-Probably latex2html outputs the latin1 file names as it gets from the command
-line binary encoded.  There are also utf8 encoded characters in the file.
-
-utf8 encoded manual name and tex4ht in latin1 locale
-./texi2any.pl --html --init init/tex4ht.pm tests/tex_html/tex_encod*_utf8.texi
-html file generated by tex4ht with content="text/html; charset=iso-8859-1">,
-with character encoded in utf8 <img src="tex_encodé_utf8_tex4ht_tex0x.png" 
...>
-firefox opens tex_encodé_utf8_html/Chapter.html but does not find the image
-and shows a path like tex_encodé_utf8_html/tex_encodé_utf8_tex4ht_tex0x.png
-mixing latin1 and utf8.
-
-
-Tests in utf8 locales.  The archive epub file is not tested in the automated 
tests.
-
-epub for utf8 encoded manual in utf8 locale
-./texi2any.pl --force -I tests/ --init init/epub3.pm 
tests/formatting/osé_utf8.texi
-
-Two following tests not important enough to have regression test
-./texi2any.pl --force -I tests/ -o encodé/raw.txt -c 
TEXINFO_OUTPUT_FORMAT=rawtext tests/formatting/os*_utf8.texi
-./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext -c 
'SUBDIR=subdîr' tests/formatting/os*_utf8.texi
-
-Test more interesting in non utf8 locale
-Add tests even if not as interesting in UTF8 locale as in non UTF8?
-./texi2any.pl --set TEXINFO_OUTPUT_FORMAT=debugtree --set USE_NODES=0 -o 
résultat/encodé.txt ./t/input_files/simplest_no_node_section.texi
 
 
 Associated code to check, requires bytes in input both for directory and
@@ -448,6 +325,160 @@ DocBook
   of each item but the standard "does not specify a set of appropriate 
keywords"
   so it cannot be used.
 
+
+Manual tests
+============
+
+Some tests are interesting but are not in the test suite for various
+reasons.  It is not really expected to have much regressions with these
+tests.  They are shown here for information.  It was up to date in
+March 2022, it may drift away as tests files names or content change.
+
+
+Tests in non utf8 locale
+------------------------
+
+In practice these tests were tested in latin1.  They are not
+in the may test suite because a latin1 locale cannot be expected
+to be present reliably.
+
+Tests with correct or acceptable results
+****************************************
+
+t/formats_encodings.t manual_simple_utf8_with_error
+utf8 manual with errors involving non ascii strings
+./texi2any.pl ./t/input_files/manual_simple_utf8_with_error.texi
+
+t/formats_encodings.t manual_simple_latin1_with_error
+latin1 manual with errors involving non ascii strings
+./texi2any.pl ./t/input_files/manual_simple_latin1_with_error.texi
+
+tests/formatting cpp_lines
+CPP directive with non ascii characters, utf8 manual
+./texi2any.pl -I ./t/include/ ./t/input_files/cpp_lines.texi
+accentêd:7: warning: làng is not a valid language code
+The file is UTF-8 encoded, the @documentencoding is obeyed which leads
+in the Parser, to an UTF-8 encoding of include file name, and not to the latin1
+encoding which should be used for the output messages encoding.
+This output is by (Gavin) design.
+
+many_input_files/output_dir_file_non_ascii.sh
+non ascii output directory, utf8 manual
+./texi2any.pl -o encodé/ ./t/input_files/simplest.texi
+
+test of non ascii included file name in utf8 locale is already in formatting:
+formatting/osé_utf8.texi:@include included_akçentêd.texi
+./texi2any.pl --force -I tests/ tests/formatting/os*_utf8.texi
+The file name is utf-8 encoded in messages, which is expected as we do not
+decode/encode file names from the command line for messages
+osé_utf8.texi:15: warning: undefined flag: vùr
+
+t/80include.t cpp_line_latin1
+CPP directive with non ascii characters, latin1 manual
+./texi2any.pl --force ./t/input_files/cpp_line_latin1.texi
+
+Issue to add 'tests/included_lat'$'\356''n1.texi' in make dist
+tests/other manual_include_accented_file_name_latin1
+./texi2any.pl --force -I tests/ 
tests/other/manual_include_accented_file_name_latin1.texi
+
+latin1 encoded and latex2html in latin1 locale
+./texi2any.pl --html --init init/latex2html.pm 
tests/tex_html/tex_encode_latin1.texi
+
+latin1 encoded and tex4ht in latin1 locale
+./texi2any.pl --html --init init/tex4ht.pm 
tests/tex_html/tex_encode_latin1.texi
+
+./texi2any.pl --html --init init/tex4ht.pm tex_encodé_latin1.texi
+Firefox can't find tex_encod%uFFFD_latin1_html/Chapter.html (?)
+Opened from within the directory, still can't find the image file:
+tex_encod%E9_latin1_html/tex_encod%C3%A9_latin1_tex4ht_tex0x.png
+The file names and file contents looks right, though, with latin1 only
+encoded characters.
+
+epub for utf8 encoded manual in latin1 locale
+./texi2any.pl --force -I tests/ --init init/epub3.pm 
tests/formatting/os*_utf8.texi
+
+epub for latin1 encoded manual in latin1 locale
+cp tests/tex_html/tex_encode_latin1.texi tex_encodé_latin1.texi
+./texi2any.pl --init init/epub3.pm tex_encodé_latin1.texi
+
+./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext 
tests/formatting/os*_utf8.texi
+output file name is in latin1, but the encoding inside is utf8 consistent
+with the document encoding.
+
+./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext 
tests/formatting/os*_utf8_no_setfilename.texi
+output file name is utf8 because the utf8 encoded input file name
+is decoded using the locale latin1 encoding keeping the 8bit characters
+from the utf8 encoding, and the encoding inside is utf8
+consistent with the document encoding.
+
+./texi2any.pl --force -I tests/ -o encodé/raw.txt -c 
TEXINFO_OUTPUT_FORMAT=rawtext tests/formatting/os*_utf8.texi
+encodé/raw.txt encoded in latin1, and the encoding inside is utf8
+consistent with the document encoding.
+
+./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext -c 
'SUBDIR=subdîr' tests/formatting/os*_utf8.texi
+subdîr/osé_utf8.txt encoded in latin1, and the encoding inside is utf8
+consistent with the document encoding.
+
+./texi2any.pl --set TEXINFO_OUTPUT_FORMAT=debugtree --set USE_NODES=0 -o 
résultat/encodé.txt ./t/input_files/simplest_no_node_section.texi
+résultat/encodé.txt file name encoded in latin1.
+
+./texi2any.pl --set TEXINFO_OUTPUT_FORMAT=debugtree --set USE_NODES=0 -o 
char_latin1_latin1_in_refs_tree.txt 
./t/input_files/char_latin1_latin1_in_refs.texi
+char_latin1_latin1_in_refs_tree.txt content encoded in latin1
+
+Tests with incorrect results, though not bugs
+*********************************************
+
+utf8 encoded manual name and latex2html in latin1 locale
+./texi2any.pl --html --init init/latex2html.pm 
tests/tex_html/tex_encod*_utf8.texi
+ -> the input file name is decoded using DATA_INPUT_ENCODING_NAME
+    which is set to ISO-8859-1, although the file name is in utf8.
+./texi2any.pl -c 'DATA_INPUT_ENCODING_NAME utf-8' -c 'L2H_CLEAN 0' --html 
--init init/latex2html.pm tests/tex_html/tex_encod*_utf8.texi
+Errors out with
+utf8 "\xE9" does not map to Unicode at ./init/latex2html.pm line 515, 
<L2H_HTML> line 6.
+which corresponds to tex_encodé_utf8_html/tex_encodé_utf8_l2h.html
+<TITLE>tex_encodé_utf8_l2h</TITLE>, with the é encoded in latin1.
+Probably latex2html outputs the latin1 file names as it gets from the command
+line binary encoded.  There are also utf8 encoded characters in the file.
+
+latin1 encoded manual name and latex2html in latin1 locale
+cp tests/tex_html/tex_encode_latin1.texi tex_encodé_latin1.texi
+./texi2any.pl -c 'L2H_CLEAN 0' --html --init init/latex2html.pm 
tex_encodé_latin1.texi
+Errors out with
+utf8 "\xE9" does not map to Unicode at ./init/latex2html.pm line 515, 
<L2H_HTML> line 6.
+which corresponds to tex_encodé_latin1_html/tex_encodé_latin1_l2h.html
+<TITLE>tex_encodé_latin1_l2h</TITLE> with the é encoded in latin1.
+Probably latex2html outputs the latin1 file names as it gets from the command
+line binary encoded.  There are also utf8 encoded characters in the file.
+
+utf8 encoded manual name and tex4ht in latin1 locale
+./texi2any.pl --html --init init/tex4ht.pm tests/tex_html/tex_encod*_utf8.texi
+html file generated by tex4ht with content="text/html; charset=iso-8859-1">,
+with character encoded in utf8 <img src="tex_encodé_utf8_tex4ht_tex0x.png" 
...>
+firefox opens tex_encodé_utf8_html/Chapter.html but does not find the image
+and shows a path like tex_encodé_utf8_html/tex_encodé_utf8_tex4ht_tex0x.png
+mixing latin1 and utf8.
+
+
+Tests in utf8 locales
+---------------------
+
+The archive epub file is not tested in the automated tests.
+
+epub for utf8 encoded manual in utf8 locale
+./texi2any.pl --force -I tests/ --init init/epub3.pm 
tests/formatting/osé_utf8.texi
+
+The following tests not important enough to have regression test
+./texi2any.pl --force -I tests/ -o encodé/raw.txt -c 
TEXINFO_OUTPUT_FORMAT=rawtext tests/formatting/os*_utf8.texi
+./texi2any.pl --force -I tests/ -c TEXINFO_OUTPUT_FORMAT=rawtext -c 
'SUBDIR=subdîr' tests/formatting/os*_utf8.texi
+
+Test more interesting in non utf8 locale
+./texi2any.pl --set TEXINFO_OUTPUT_FORMAT=debugtree --set USE_NODES=0 -o 
résultat/encodé.txt ./t/input_files/simplest_no_node_section.texi
+résultat/encodé.txt file name encoded in utf8
+
+./texi2any.pl --set TEXINFO_OUTPUT_FORMAT=debugtree --set USE_NODES=0 -o 
char_latin1_latin1_in_refs_tree.txt 
./t/input_files/char_latin1_latin1_in_refs.texi
+char_latin1_latin1_in_refs_tree.txt content encoded in latin1
+
+
 Notes
 =====