Package: libnss3-tools
Version: 2:3.107-1
Severity: minor
Tags: upstream
* 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 ' $' <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>:64: warning: trailing space in the line
troff:<stdin>:74: warning: trailing space in the line
troff:<stdin>:83: warning: trailing space in the line
troff:<stdin>:98: warning: trailing space in the line
troff:<stdin>:103: 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.9-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 libnss3-tools depends on:
ii libc6 2.40-5
ii libnspr4 2:4.36-1
ii libnss3 2:3.107-1
ii zlib1g 1:1.3.dfsg+really1.3.1-1+b1
libnss3-tools recommends no packages.
libnss3-tools suggests no packages.
-- no debconf information
Input file is vfychain.1
Output from "mandoc -T lint vfychain.1": (shortened list)
1 input text line longer than 80 bytes: 0=SSL client, 1=SSL ...
1 input text line longer than 80 bytes: Authors: Elio Maldon...
1 input text line longer than 80 bytes: For information abou...
1 input text line longer than 80 bytes: Licensed under the M...
1 input text line longer than 80 bytes: Revocation options f...
1 input text line longer than 80 bytes: Sets method type for...
2 input text line longer than 80 bytes: Sets revocation flag...
1 input text line longer than 80 bytes: The NSS tools were w...
1 input text line longer than 80 bytes: The tasks associated...
1 input text line longer than 80 bytes: This documentation i...
1 input text line longer than 80 bytes: Trust both explicit ...
1 input text line longer than 80 bytes: Verbose mode\&. Prin...
1 input text line longer than 80 bytes: can add and delete P...
1 input text line longer than 80 bytes: vfychain_ \- vfychai...
6 skipping paragraph macro: PP after SH
-.-.
Output from "test-groff -mandoc -t -ww -z vfychain.1": (shortened list)
5 trailing space in the line
-.-.
Show if docman-to-man created this.
Who is actually creating this man page? Debian or upstream?
Is the generating software out of date?
4:.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.-.
No need for "\&" to be in front of a period (.),
if there is a character in front of it
31:vfychain_ \- vfychain [options] [revocation options] certfile [[options]
certfile] \&.\&.\&.
37:This documentation is still work in progress\&. Please contribute to the
initial review in
42:\fBvfychain\fR, verifies certificate chains\&.
44:can add and delete PKCS #11 modules, change passwords on security databases,
set defaults, list module contents, enable or disable slots, enable or disable
FIPS 140\-2 compliance, and assign default providers for cryptographic
operations\&. This tool can also create certificate, key, and module security
database files\&.
46:The tasks associated with security module database management are part of a
process that typically also involves managing key databases and certificate
databases\&.
71:Set policy OID for cert validation(Format OID\&.1\&.2\&.3)
80:* CERT_PKIXVerifyCert if specified twice and more\&.
100:Trust both explicit trust anchors (\-t) and the database\&. (Without this
option, the default is to only trust certificates marked \-t, if there are any,
or to trust the database if there are certificates marked \-t\&.)
105:Verbose mode\&. Prints root cert subject(double the argument for whole root
cert info)
119:Revocation options for PKIX API (invoked with \-pp options) is a collection
of the following flags: [\-g type [\-h flags] [\-m type [\-s flags]] \&.\&.\&.]
\&.\&.\&.
126:Sets status checking test type\&. Possible values are "leaf" or "chain"
131:Sets status checking test type\&. Possible values are "leaf" or "chain"\&.
136:Sets revocation flags for the test type it follows\&. Possible flags:
"testLocalInfoFirst" and "requireFreshInfo"\&.
141:Sets method type for the test type it follows\&. Possible types are "crl"
and "ocsp"\&.
146:Sets revocation flags for the method it follows\&. Possible types are
"doNotUse", "forbidFetching", "ignoreDefaultSrc", "requireInfo" and
"failIfNoInfo"\&.
151:\m[blue]\fBhttp://www\&.mozilla\&.org/projects/security/pki/nss/\fR\m[]\&;.
The NSS site relates directly to NSS code changes and releases\&.
153:Mailing lists: https://lists\&.mozilla\&.org/listinfo/dev\-tech\-crypto
158:The NSS tools were written and maintained by developers with Netscape, Red
Hat, Sun, Oracle, Mozilla, and Google\&.
160:Authors: Elio Maldonado <emaldona@redhat\&.com>, Deon Lackey
<dlackey@redhat\&.com>\&.
163:Licensed under the Mozilla Public License, v\&. 2\&.0\&. If a copy of the
MPL was not distributed with this file, You can obtain one at
http://mozilla\&.org/MPL/2\&.0/\&;.
-.-.
Use ".na" (no adjustment) instead of ".ad l" and then ".ad" to begin the
same adjustment again as before
26:.ad l
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
troff:<stdin>:64: warning: trailing space in the line
troff:<stdin>:74: warning: trailing space in the line
troff:<stdin>:83: warning: trailing space in the line
troff:<stdin>:98: warning: trailing space in the line
troff:<stdin>:103: warning: trailing space in the line
-.-
Change "\fB\-p \fR" etc. (trailing space) to
.B \-p
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.
Not beginning each input sentence on a new line.
Line length 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 -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 -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)
-.-
