Bug#1099660: dh_installtex.1: Some remarks and a patch with editorial changes for this man page
Package: tex-common
Version: 6.19
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z < "man page"
[Use "groff -e ' $' -e '\\~$' <file>" to find obvious trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
troff:<stdin>:82: warning: trailing space in the line
troff:<stdin>:89: warning: trailing space in the line
troff:<stdin>:92: warning: trailing space in the line
troff:<stdin>:107: warning: trailing space in the line
troff:<stdin>:117: warning: trailing space in the line
troff:<stdin>:144: warning: trailing space in the line
troff:<stdin>:162: warning: trailing space in the line
troff:<stdin>:178: warning: trailing space in the line
troff:<stdin>:199: warning: trailing space in the line
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.12.12-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages tex-common depends on:
ii ucf 3.0050
tex-common recommends no packages.
Versions of packages tex-common suggests:
pn debhelper <none>
Versions of packages texlive-base depends on:
ii debconf [debconf-2.0] 1.5.89
ii libpaper-utils 2.2.5-0.3+b1
ii sensible-utils 0.0.24
ii texlive-binaries 2024.20240313.70630+ds-5+b1
ii ucf 3.0050
ii xdg-utils 1.2.1-2
Versions of packages texlive-base recommends:
ii lmodern 2.005-1
Versions of packages texlive-base suggests:
ii ghostscript [postscript-viewer] 10.04.0~dfsg-2+b1
ii gv [postscript-viewer] 1:3.7.4-2+b2
ii mupdf [pdf-viewer] 1.25.1+ds1-5+b2
pn perl-tk <none>
ii xpdf [pdf-viewer] 3.04+git20250103-1+b1
pn xzdec <none>
Versions of packages texlive-binaries depends on:
ii libc6 2.40-7
ii libcairo2 1.18.2-2
ii libfontconfig1 2.15.0-2
ii libfreetype6 2.13.3+dfsg-1
ii libgcc-s1 14.2.0-17
ii libgraphite2-3 1.3.14-2+b1
ii libharfbuzz0b 10.2.0-1
ii libicu72 72.1-6
ii libkpathsea6 2024.20240313.70630+ds-5+b1
ii libmpfi0 1.5.4+ds-4
ii libmpfr6 4.2.1-1+b2
ii libpaper2 2.2.5-0.3+b1
ii libpixman-1-0 0.44.0-3
ii libpng16-16t64 1.6.47-1
ii libpotrace0 1.16-2+b2
ii libptexenc1 2024.20240313.70630+ds-5+b1
ii libstdc++6 14.2.0-17
ii libsynctex2 2024.20240313.70630+ds-5+b1
ii libteckit0 2.5.12+ds1-1+b1
ii libtexlua53-5 2024.20240313.70630+ds-5+b1
ii libx11-6 2:1.8.10-2
ii libxaw7 2:1.0.16-1
ii libxi6 2:1.8.2-1
ii libxmu6 2:1.1.3-3+b4
ii libxpm4 1:3.5.17-1+b3
ii libxt6t64 1:1.2.1-1.2+b2
ii libzzip-0-13t64 0.13.78+dfsg.1-0.1
ii perl 5.40.1-2
ii t1utils 1.41-4
ii zlib1g 1:1.3.dfsg+really1.3.1-1+b1
Versions of packages texlive-binaries recommends:
pn dvisvgm <none>
ii texlive-base 2024.20250114-1
Versions of packages texlive-binaries suggests:
pn hintview <none>
pn texlive-binaries-sse2 <none>
-- debconf information excluded
Input file is dh_installtex.1
Output from "mandoc -T lint dh_installtex.1": (shortened list)
1 input text line longer than 80 bytes: If you select \fBmap...
1 input text line longer than 80 bytes: and a file /var/lib/...
1 input text line longer than 80 bytes: dh_installtex \- reg...
1 input text line longer than 80 bytes: even for those map f...
1 input text line longer than 80 bytes: on which packages to...
1 input text line longer than 80 bytes: would install a file...
9 whitespace at end of input line
Remove trailing space with: sed -e 's/ *$//'
-.-.
Output from "test-nroff -mandoc -t -ww -z dh_installtex.1": (shortened list)
9 trailing space in the line
Remove trailing space with: sed -e 's/ *$//'
-.-.
Show if Pod::Man generated this.
Who is actually creating this man page? Debian or upstream?
Is the generating software out of date?
2:.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
-.-.
Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
Number of lines affected is
9
-.-.
Reduce space between words.
dh_installtex.1:114:\& dh_installtex mapfile=foo.cfg formatfile=debian/bar.cnf
dh_installtex.1:127:\& dh_installtex map=Map,foo.map hyphen=ngerman\-x\-2011\-07\-01,dehyphn\-x\-2011\-07\-01.tex,hyph\-de\-1996.pat.txt,lhm=2,rhm=2,synonym=ngerman\-x\-latest,exceptions=hyph\-de\-1996.hyp.txt
dh_installtex.1:133:\& Map foo.map
dh_installtex.1:139:\& name=ngerman\-x\-2011\-07\-01 file=dehyphn\-x\-2011\-07\-01.tex file_patterns=hyph\-de\-1996.pat.txt lefthyphenmin=2 righthyphenmin=2 synonym=ngerman\-x\-latest file_exceptions=hyph\-de\-1996.hyp.txt
dh_installtex.1:155:\& dh_installtex
-.-.
Strings longer than 3/4 of a standard line length (80)
Use "\:" to split the string at the end of an output line, for example a
long URL (web address)
75 [\fBhyphen=\fR\fIlang\fR,\fIfile\fR[,lhm=\fIn\fR][,rhm=\fIn\fR][,synonym=\fIsyn\fR,...]]
77 [\fBformat=\fR\fIformat\fR,\fIengine\fR,\fIhyphenfile\fR,\fIrest args\fR]
127 \& dh_installtex map=Map,foo.map hyphen=ngerman\-x\-2011\-07\-01,dehyphn\-x\-2011\-07\-01.tex,hyph\-de\-1996.pat.txt,lhm=2,rhm=2,synonym=ngerman\-x\-latest,exceptions=hyph\-de\-1996.hyp.txt
-.-.
Add a "\&" (or a comma (Oxford comma)) after "e.g." and "i.e.",
or use English words
(man-pages(7)).
Abbreviation points should be marked as such and protected against being
interpreted as an end of sentence, if they are not, and that independent
of the current place on the line.
185:(i.e. uncommented) map in each of the cfg file generated by one of the
-.-.
Wrong distance between sentences in the input file.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
Mark a final abbreviation point as such by suffixing it with "\&".
Some sentences (etc.) do not begin on a new line.
Split (sometimes) lines after a punctuation mark; before a conjunction.
Lines with only one (or two) space(s) between sentences could be split,
so latter sentences begin on a new line.
Use
#!/usr/bin/sh
sed -e '/^\./n' \
-e 's/\([[:alpha:]]\)\. */\1.\n/g' $1
to split lines after a sentence period.
Check result with the difference between the formatted outputs.
See also the attachment "general.bugs"
[List of affected lines removed.]
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
Add "\:" to split the string for the output, "\<newline>" in the source.
[List of affected lines removed.]
-.-
Line 58, length 83
.TH DH_INSTALLTEX 1 2025-02-28 "perl v5.40.1" "User Contributed Perl Documentation"
Line 64, length 81
dh_installtex \- register Type 1 fonts, hyphenation patterns, or formats with TeX
Line 75, length 88
[\fBhyphen=\fR\fIlang\fR,\fIfile\fR[,lhm=\fIn\fR][,rhm=\fIn\fR][,synonym=\fIsyn\fR,...]]
Line 89, length 82
\&\fBWARNING\fR This program does \fBnot\fR check for the actual existence of any
Line 91, length 104
on which packages to work on (using \f(CW\*(C`\-p\*(C'\fR or \f(CW\*(C`\-N\*(C'\fR) it will add calls to
Line 127, length 196
\& dh_installtex map=Map,foo.map hyphen=ngerman\-x\-2011\-07\-01,dehyphn\-x\-2011\-07\-01.tex,hyph\-de\-1996.pat.txt,lhm=2,rhm=2,synonym=ngerman\-x\-latest,exceptions=hyph\-de\-1996.hyp.txt
Line 130, length 92
would install a file /var/lib/tex\-common/fontmap\-cfg/texmf/package.cfg containing the line
Line 136, length 82
and a file /var/lib/tex\-common/hyphen\-cnf/texmf/package.cnf containing the lines
Line 139, length 205
\& name=ngerman\-x\-2011\-07\-01 file=dehyphn\-x\-2011\-07\-01.tex file_patterns=hyph\-de\-1996.pat.txt lefthyphenmin=2 righthyphenmin=2 synonym=ngerman\-x\-latest file_exceptions=hyph\-de\-1996.hyp.txt
Line 184, length 86
\&\fBmap:config_for_active_maps\fR will create a file \fIconfig.bar\fR for each active
Line 189, length 85
If you select \fBmap:config_for_all_maps\fR the script will generate \fIconfig.bar\fR
Line 190, length 87
even for those map files which are present in a cfg file, but deactivated by a comment.
Line 198, length 88
\&\fBformat:add_one:\fR\f(BIformatname\fR allows one to add the generation of a specific
-.-.
Remove unnecessary double font change (e.g., \fR\fI) in a row or (better)
use a two-fonts macro.
70:[\fB\-\-flavor=\fR\fIflavor\fR[,\fIflavor\fR]]
71:[\fBmap=MixedMap,\fR\fIfile.map\fR]
72:[\fBmap=Map,\fR\fIfile.map\fR]
73:[\fBmap=KanjiMap,\fR\fIfile.map\fR]
74:[\fBmapfile=\fR\fIfile.cfg\fR]
75:[\fBhyphen=\fR\fIlang\fR,\fIfile\fR[,lhm=\fIn\fR][,rhm=\fIn\fR][,synonym=\fIsyn\fR,...]]
76:[\fBhyphenfile=\fR\fIfile.cnf\fR]
77:[\fBformat=\fR\fIformat\fR,\fIengine\fR,\fIhyphenfile\fR,\fIrest args\fR]
78:[\fBformatfile=\fR\fIfile.cnf\fR]
171:.IP \fB\-\-flavor=\fR\fIflavor\fR[,\fIflavor\fR] 4
-.-.
Add a zero (0) in front of a decimal fraction that begins with a period
(.)
7:.if t .sp .5v
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
dh_installtex.1:91:on which packages to work on (using \f(CW\*(C`\-p\*(C'\fR or \f(CW\*(C`\-N\*(C'\fR) it will add calls to
dh_installtex.1:162:The command line items (Variant 2) are merged into the debian/package.maps
dh_installtex.1:164:an additional package.cfg/cnf (Variant 1) this will raise an error since
dh_installtex.1:199:format without actually providing it (in a cnf file). This is useful if a
-.-.
Space after an end of sentence.
dh_installtex.1:86:that the update\-* commands are available. (This program adds that
dh_installtex.1:90:input files in TEXMF trees. If you call it without any further specification
dh_installtex.1:92:management functions to \fBall\fR packages. In this case don't forget to
dh_installtex.1:121:You can specify maps, formats, and hyphenations on the cmd line. The items
dh_installtex.1:145:debian/package.formats or debian/formats. These files are
dh_installtex.1:146:installed with the name of the package. Each of these
dh_installtex.1:148:is told to act on. By default this is the first binary package in
dh_installtex.1:163:(debian/package.hyphens, debian/package.formats) file. If you specify
dh_installtex.1:174:/usr/share/texmf, and to switch on additional options. The argument
dh_installtex.1:185:(i.e. uncommented) map in each of the cfg file generated by one of the
dh_installtex.1:186:three methods described above. These files are installed in
dh_installtex.1:192:The file \fIconfig.bar\fR is used when called by `dvips \-Pbar ...'. Thus it
dh_installtex.1:199:format without actually providing it (in a cnf file). This is useful if a
dh_installtex.1:205:/usr/bin/\fIformat\fR that points to the corresponding engine. For
dh_installtex.1:208:The flavor \fBformat:no_links\fR inhibits this. If a link already
dh_installtex.1:215:Note that this command is not idempotent. "dh_clean \-k" should be called
-.-.
Put a subordinate sentence (after a comma) on a new line.
dh_installtex.1:64:dh_installtex \- register Type 1 fonts, hyphenation patterns, or formats with TeX
dh_installtex.1:82:updating the ls-R databases, registering map files, new formats,
dh_installtex.1:96:If you only install files into /usr/share/texmf, nothing has to be done,
dh_installtex.1:100:If in addition, you have to install map files, hyphenation patterns for
dh_installtex.1:101:additional languages, or format definitions you can use three
dh_installtex.1:106:\&\fItype\fR can be one of map, format and hyphen, and these files will be
dh_installtex.1:108:(fontmap-cfg for map files, hyphen-cnf for hyphenation patterns,
dh_installtex.1:117:would install foo.cfg as /var/lib/tex\-common/fontmap\-cfg/texmf/foo.cfg,
dh_installtex.1:121:You can specify maps, formats, and hyphenations on the cmd line. The items
dh_installtex.1:144:debian/package.hyphens or debian/hyphens,
dh_installtex.1:149:debian/control, but if you use \-p, \-i, or \-a flags, it will be the first
dh_installtex.1:163:(debian/package.hyphens, debian/package.formats) file. If you specify
dh_installtex.1:174:/usr/share/texmf, and to switch on additional options. The argument
dh_installtex.1:178:\&\fBmap:config_for_active_maps\fR, \fBmap:config_for_all_maps\fR,
dh_installtex.1:190:even for those map files which are present in a cfg file, but deactivated by a comment.
dh_installtex.1:203:Usually, for every format that is specified in a configuration file,
dh_installtex.1:206:example, /usr/bin/latex would be created as a symlink to pdftex.
dh_installtex.1:209:exists, dh_installtex will skip this format with an informational
dh_installtex.1:210:message, even if this option is not given.
dh_installtex.1:216:between invocations of this command, unless using the \fB\-n\fR option.
dh_installtex.1:217:Otherwise, it may cause multiple instances of the same text to be added
-.-.
Use ".na" (no adjustment) instead of ".ad l" (and ".ad" to begin the
same adjustment again as before).
61:.if n .ad l
-.-.
Add lines to use the CR font for groff instead of CW.
.if t \{\
. ie \\n(.g .ft CR
. el .ft CW
.\}
11:.ft CW
-.-.
Section headings (.SH and .SS) do not need quoting their arguments.
94:.SH "SIMPLE USAGE: Registering Files"
98:.SH "COMPLEX USAGE: Registering fonts, hyphenation patterns and formats"
160:.SS "Mixing the different variants"
222:.SH "SEE ALSO"
-.-.
.\" Define a fallback for font CW with
.if t \{\
. ie \n(.g .ds fC \f(CR
. el .ds fC \f(CW
. \}
. ds fP \fP
.\}
.
.if n \{\
. ds fC \fR
. ds fP \fP
.\}
91:on which packages to work on (using \f(CW\*(C`\-p\*(C'\fR or \f(CW\*(C`\-N\*(C'\fR) it will add calls to
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z ":
troff:<stdin>:82: warning: trailing space in the line
troff:<stdin>:89: warning: trailing space in the line
troff:<stdin>:92: warning: trailing space in the line
troff:<stdin>:107: warning: trailing space in the line
troff:<stdin>:117: warning: trailing space in the line
troff:<stdin>:144: warning: trailing space in the line
troff:<stdin>:162: warning: trailing space in the line
troff:<stdin>:178: warning: trailing space in the line
troff:<stdin>:199: warning: trailing space in the line
-.-
Generally:
Split (sometimes) lines after a punctuation mark; before a conjunction.
--- dh_installtex.1 2025-03-06 11:58:56.695027843 +0000
+++ dh_installtex.1.new 2025-03-06 12:28:55.257639867 +0000
@@ -79,17 +79,17 @@ dh_installtex \- register Type 1 fonts,
.SH DESCRIPTION
.IX Header "DESCRIPTION"
dh_installtex is a debhelper program that is responsible for
-updating the ls-R databases, registering map files, new formats,
+updating the ls-R databases, registering map files, new formats,
and new hyphenation patterns with TeX.
.PP
Your package should depend on an appropriate version of tex-common so
that the update\-* commands are available. (This program adds that
dependency to ${misc:Depends}.)
.PP
-\&\fBWARNING\fR This program does \fBnot\fR check for the actual existence of any
+\&\fBWARNING\fR This program does \fBnot\fR check for the actual existence of any
input files in TEXMF trees. If you call it without any further specification
on which packages to work on (using \f(CW\*(C`\-p\*(C'\fR or \f(CW\*(C`\-N\*(C'\fR) it will add calls to
-management functions to \fBall\fR packages. In this case don't forget to
+management functions to \fBall\fR packages. In this case don't forget to
add ${misc:Depends} to all packages' dependencies.
.SH "SIMPLE USAGE: Registering Files"
.IX Header "SIMPLE USAGE: Registering Files"
@@ -104,7 +104,7 @@ different methods to specify what should
1) \fBPre made config files:\fR These files can be specified with the
different \fItype\fRfile= options.
\&\fItype\fR can be one of map, format and hyphen, and these files will be
-installed into /var/lib/tex\-common/\fIconfigdir\fR/ for the respective type
+installed into /var/lib/tex\-common/\fIconfigdir\fR/ for the respective type
(fontmap-cfg for map files, hyphen-cnf for hyphenation patterns,
and fmtutil-cnf for format definitions).
.PP
@@ -114,7 +114,7 @@ Example:
\& dh_installtex mapfile=foo.cfg formatfile=debian/bar.cnf
.Ve
.PP
-would install foo.cfg as /var/lib/tex\-common/fontmap\-cfg/texmf/foo.cfg,
+would install foo.cfg as /var/lib/tex\-common/fontmap\-cfg/texmf/foo.cfg,
and debian/bar.cnf as /var/lib/tex\-common/fmtutil\-cnf/texmf/bar.cnf.
.PP
2) \fBDirectly on the cmd line:\fR
@@ -124,7 +124,9 @@ are stored in the respective config file
Example:
.PP
.Vb 1
-\& dh_installtex map=Map,foo.map hyphen=ngerman\-x\-2011\-07\-01,dehyphn\-x\-2011\-07\-01.tex,hyph\-de\-1996.pat.txt,lhm=2,rhm=2,synonym=ngerman\-x\-latest,exceptions=hyph\-de\-1996.hyp.txt
+ dh_installtex map=Map,foo.map hyphen=ngerman\-x\-2011\-07\-01,\e
+ dehyphn\-x\-2011\-07\-01.tex,\:hyph\-de\-1996.pat.txt,\:lhm=2,\e
+ rhm=2,synonym=ngerman\-x\-latest,exceptions=hyph\-de\-1996.hyp.txt
.Ve
.PP
would install a file /var/lib/tex\-common/fontmap\-cfg/texmf/package.cfg containing the line
@@ -136,12 +138,18 @@ would install a file /var/lib/tex\-commo
and a file /var/lib/tex\-common/hyphen\-cnf/texmf/package.cnf containing the lines
.PP
.Vb 1
-\& name=ngerman\-x\-2011\-07\-01 file=dehyphn\-x\-2011\-07\-01.tex file_patterns=hyph\-de\-1996.pat.txt lefthyphenmin=2 righthyphenmin=2 synonym=ngerman\-x\-latest file_exceptions=hyph\-de\-1996.hyp.txt
+ name=ngerman\-x\-2011\-07\-01
+ file=dehyphn\-x\-2011\-07\-01.tex
+ file_patterns=hyph\-de\-1996.pat.txt
+ lefthyphenmin=2
+ righthyphenmin=2
+ synonym=ngerman\-x\-latest
+ file_exceptions=hyph\-de\-1996.hyp.txt
.Ve
.PP
3) \fBPackage files:\fR
You create a file debian/package.maps or debian/maps,
-debian/package.hyphens or debian/hyphens,
+debian/package.hyphens or debian/hyphens,
debian/package.formats or debian/formats. These files are
installed with the name of the package. Each of these
files will be installed into the first package dh_installtex
@@ -159,7 +167,7 @@ would install a present debian/package.f
/var/lib/tex\-common/fmtutil\-cnf/texmf/package.cnf.
.SS "Mixing the different variants"
.IX Subsection "Mixing the different variants"
-The command line items (Variant 2) are merged into the debian/package.maps
+The command line items (Variant 2) are merged into the debian/package.maps
(debian/package.hyphens, debian/package.formats) file. If you specify
an additional package.cfg/cnf (Variant 1) this will raise an error since
both files would be installed as package.cfg/cnf.
@@ -175,7 +183,7 @@ This option is used to select a differen
specify a list from flavors to be selected.
At the moment you can select from the following list of flavors:
\&\fBtree:texlive\fR,
-\&\fBmap:config_for_active_maps\fR, \fBmap:config_for_all_maps\fR,
+\&\fBmap:config_for_active_maps\fR, \fBmap:config_for_all_maps\fR,
\&\fBformat:add_one:\fR\f(BIformatname\fR.
.Sp
\&\fBtree:texlive\fR will select the tree /usr/share/texlive/texmf\-dist and
@@ -196,7 +204,7 @@ activated via the updmap(\-sys) mechanis
Default is \fInot\fR to generate any config files.
.Sp
\&\fBformat:add_one:\fR\f(BIformatname\fR allows one to add the generation of a specific
-format without actually providing it (in a cnf file). This is useful if a
+format without actually providing it (in a cnf file). This is useful if a
package adds hyphenation patterns to an existing formats.
.Sp
\&\fBformat:no_links\fR:
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
The same goes for man pages that are used as an input.
For a style guide use
mandoc -T lint
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
"git" has a "tool" to point out whitespace,
see for example "git-apply(1)" and git-config(1)")
Not beginning each input sentence on a new line.
Line length and patch size should thus be reduced.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original and patched file
can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -d -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -d -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option \"-warnings=w\"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT=\"-ww -b -z\"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
Reply to: