Your message dated Sun, 14 Sep 2025 12:33:52 +0000
with message-id <[email protected]>
and subject line Bug#1105900: fixed in adduser 3.153
has caused the Debian Bug report #1105900,
regarding adduser.local.8: Some remarks and a patch with editorial changes for
this man page
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
1105900: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1105900
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: adduser
Version: 3.152
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
grep -n -e ' $' -e '\\~$' -e ' \\f.$' -e ' \\"' <file>
to find (most) 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?
Output from "test-nroff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
an.tmac:<stdin>:5: style: .TH missing third argument; consider document
modification date in ISO 8601 format (YYYY-MM-DD)
troff:<stdin>:16: warning [page 1, line 9]: cannot break line; overset by 31n
troff:<stdin>:17: warning [page 1, line 10]: cannot break line; overset by 12n
troff:<stdin>:18: warning [page 1, line 11]: cannot break line; overset by 12n
troff:<stdin>:19: warning [page 1, line 12]: cannot break line; overset by 13n
troff:<stdin>:19: warning [page 1, line 13]: cannot break line; overset by 17n
* 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.27-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 adduser depends on:
ii passwd 1:4.17.4-2
adduser recommends no packages.
Versions of packages adduser suggests:
ii cron 3.0pl1-196
ii liblocale-gettext-perl 1.07-7+b1
ii perl 5.40.1-3
pn quota <none>
-- no debconf information
Input file is adduser.local.8
Output from "mandoc -T lint adduser.local.8": (shortened list)
1 missing date, using ""
Find trailing space with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Output from
test-nroff -mandoc -t -ww -z adduser.local.8: (shortened list)
2 cannot break line; overset by 12n
1 cannot break line; overset by 13n
1 cannot break line; overset by 17n
1 cannot break line; overset by 31n
-.-.
Reduce space between words.
adduser.local.8:38:if \-\-quiet is specified
-.-.
Output from "test-nroff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
an.tmac:<stdin>:5: style: .TH missing third argument; consider document
modification date in ISO 8601 format (YYYY-MM-DD)
troff:<stdin>:16: warning [page 1, line 9]: cannot break line; overset by 31n
troff:<stdin>:17: warning [page 1, line 10]: cannot break line; overset by 12n
troff:<stdin>:18: warning [page 1, line 11]: cannot break line; overset by 12n
troff:<stdin>:19: warning [page 1, line 12]: cannot break line; overset by 13n
troff:<stdin>:19: warning [page 1, line 13]: cannot break line; overset by 17n
-.-.
Additionally:
Add a missing 'YS' macro.
Add an empty argument to the OP macro to make the argument name (to be
replaced) to be typeset as italic.
-.-
Generally:
Split (sometimes) lines after a punctuation mark; before a conjunction.
--- adduser.local.8 2025-05-15 15:38:24.601574660 +0000
+++ adduser.local.8.new 2025-05-15 15:52:58.594973964 +0000
@@ -8,15 +8,16 @@ adduser.local, deluser.local \-
hook for local actions in adduser and deluser
.SH SYNOPSIS
.SY adduser.local
-.OP username
-.OP uid
-.OP gid
-.OP home-directory
+.OP "" username
+.OP "" uid
+.OP "" gid
+.OP "" home-directory
+.YS
.SY deluser.local
-.OP username
-.OP uid
-.OP gid
-.OP home-directory
+.OP "" username
+.OP "" uid
+.OP "" gid
+.OP "" home-directory
.YS
.SH DESCRIPTION
\fBadduser.local\fP and \fBdeluser.local\fP
@@ -35,7 +36,7 @@ Return values from the hooks are ignored
.SH ENVIRONMENT
.B VERBOSE
.IP 0
-if \-\-quiet is specified
+if \-\-quiet is specified
.IP 1
if neither \-\-quiet nor \-\-debug is specified
.IP 2
@@ -50,4 +51,3 @@ if \-\-debug is specified
.BR useradd (8),
.BR usermod (8),
Debian Policy 9.2.2.
-
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>
To find trailing space use
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <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)
-.-
--- End Message ---
--- Begin Message ---
Source: adduser
Source-Version: 3.153
Done: Marc Haber <[email protected]>
We believe that the bug you reported is fixed in the latest version of
adduser, which is due to be installed in the Debian FTP archive.
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Marc Haber <[email protected]> (supplier of updated adduser
package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
Format: 1.8
Date: Sun, 14 Sep 2025 13:53:43 +0200
Source: adduser
Architecture: source
Version: 3.153
Distribution: unstable
Urgency: medium
Maintainer: Debian Adduser Developers <[email protected]>
Changed-By: Marc Haber <[email protected]>
Closes: 1105900 1107990 1108017 1112486
Changes:
adduser (3.153) unstable; urgency=medium
.
[ Marc Haber ]
* various manual page fixes. Thanks to Bjarni Ingi
Gislason <[email protected]> (Closes: #1107990, #1105900)
* move PATH initialization very early in program.
Thanks to Luca Boccassi (Closes: #1108017)
* use sanitize_string with replace in find_match.
Thanks to Rob Browning (Closes: #1112486)
.
[ Alexander Golubev ]
* Some minor messages' fixes.
Checksums-Sha1:
c9b0306457bcb56815085abee0503aca713ff997 1678 adduser_3.153.dsc
65084ea26cb0f7beb433d8154d139c3aadba2564 335872 adduser_3.153.tar.xz
8d8e56a8c60ab52e04fa9a755050f412f4df1d75 5843 adduser_3.153_source.buildinfo
Checksums-Sha256:
11c160fd57684ed1a065fc5368136f0c61005bfa4f416f32863d9dcf73b50278 1678
adduser_3.153.dsc
10803e565e1bf67d5b7eed27d0ea89bb6f46ab8e7cdd2e7c77c8f367ac334420 335872
adduser_3.153.tar.xz
1d898f1e00f6ba06e2cf157bac853c3ddc77515f853e7226b6b1df4c8f3ad9cd 5843
adduser_3.153_source.buildinfo
Files:
b3e786043efe48bed951511e9561d0ba 1678 admin important adduser_3.153.dsc
7e34ed632cc2624f6db460c4d5f48ed0 335872 admin important adduser_3.153.tar.xz
42da9f2513b70f58bdb6e615625b788b 5843 admin important
adduser_3.153_source.buildinfo
-----BEGIN PGP SIGNATURE-----
iQIzBAEBCgAdFiEE6QL5UJ/L0pcuNEbjj3cgEwEyBEIFAmjGrkoACgkQj3cgEwEy
BELFwA//dXPwHTiXQs2ZaDUOCbuEmJggPeUm8UTszeGFjZ3lIQ6/dui8nKbU48f/
UQf8pW84qgYjQ+anbGgU1edHvCVtloZAHw55agdRjNV9pgxtfB4DTGB3IR1Sdjsu
c/khewFyytSEltgj9ge4mt47p1dRQjoOC5VaMJemPQr8xE0JdveYwdEEmsqIidPV
Kpu/Kid2TkqPMrItS9WbUB20lsxE1pQjbk0XHtizHTTm+IskuiBIa+nOXkKZPBoD
Z8SGe71ZiMVt6GSn/iXP9dv0xkuv2oh2BKVE1BDyvfcnWPOzk1DhIfBtXrVXLMHR
HDsTVmb9GY3Alji1rK3DPc5UAnaUU4YSwZh7d8AtU9tFLYM1Lw951G5hL1uGahYB
V9EuZEraCSA80cgotv7cNqg9gNY+RADy/VDslnGMdfk6/ca4C9i87zF9ZIHoetmF
BKwy0tdtErGD5aGhaunyIv+Xe/1egtSUL0MBpQDPtcRs+p7C8J3U02ktGP5j09JR
BTSxkc1+22Ab+mflJi0CtzMA9Pr3XzhWnr5nhkolgmLXyRT+JfynFaydzuh0i2qH
tPoWPzCWTenu5nnJWTDwFsypNajeOFRueN9ou1VQ1alrHCDBlpHQwAZ8lBYx+L8i
EiFRVQGRsRHSK3ArT2OQVfzUDKjL77gPXuihYJ43yxlOk6ky8aI=
=nLqX
-----END PGP SIGNATURE-----
pgpiIKg4JMnVV.pgp
Description: PGP signature
--- End Message ---
