[tex-live] Problems in devnag.1, synctex.1

esr at thyrsus.com esr at thyrsus.com
Tue Jun 12 21:16:13 CEST 2018


This is automatically generated email about markup problems in a man
page for which you appear to be responsible.  If you are not the right
person or list, please tell me so I can correct my database.

See http://catb.org/~esr/doclifter/bugs.html for details on how and
why these patches were generated.  Feel free to email me with any
questions.  Note: These patches do not change the modification date of
any manual page.  You may wish to do that by hand.

I apologize if this message seems spammy or impersonal. The volume of
markup bugs I am tracking is over five hundred - there is no real
alternative to generating bugmail from a database and template.

--
                             Eric S. Raymond
-------------- next part --------------
Problems with devnag.1:

Ambiguous or invalid backslash.  This doesn't cause groff a problem.
but it confuses doclifter and may confuse older troff implementations.

--- devnag.1-unpatched	2012-07-06 10:48:31.946717382 -0400
+++ devnag.1	2012-07-06 10:49:24.874716396 -0400
@@ -7,7 +7,7 @@
 .PP
 .B devnag
 is a preprocessor that reads transliterated Devanagari input delimited by
-\dn and converts it into a form with which TeX is familiar.
+\\dn and converts it into a form with which TeX is familiar.
 .PP
 The preprocessor
 handles the details of character placement such as the alignment of
-------------- next part --------------
Problems with synctex.1:

List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
Common causes include .TP just before a section header, .TP entries
with tags but no bodies, and mandoc lists with no trailing .El.
These confuse doclifter, and may also mess up stricter man-page
browsers like Xman and Rosetta.

--- synctex.1-unpatched	2018-05-28 03:39:05.347651587 -0400
+++ synctex.1	2018-05-28 03:39:44.143387929 -0400
@@ -14,18 +14,20 @@
 .Pp
 Run `synctex help' to access the built-in tool documentation.
 .Sh TEX ENGINE OPTION -synctex=NUMBER
+.Bl -bullet compact
 .It
-.Li If NUMBER=0 or no option is given, no synctex file is created.
+If NUMBER=0 or no option is given, no synctex file is created.
 .It
-.Li If NUMBER<0, synctex files are text files.
+If NUMBER<0, synctex files are text files.
 .It
-.Li If NUMBER>0, synctex files are compressed with gz.
+If NUMBER>0, synctex files are compressed with gz.
 .It
-.Li If NUMBER&2, no .gz extension is used.
+If NUMBER&2, no .gz extension is used.
 .It
-.Li If NUMBER&4, activate form support, useful for pdftex.
+If NUMBER&4, activate form support, useful for pdftex.
 .It
-.Li If NUMBER&8, better file compression.
+If NUMBER&8, better file compression.
+.El
 .Pp
 Use for example `pdftex -synctex=15 foo.tex' to activate all the options.
 .Pp


More information about the tex-live mailing list