Your message dated Fri, 02 May 2025 13:51:28 +0000
with message-id <[email protected]>
and subject line Bug#1095890: fixed in man-db 2.13.1-1
has caused the Debian Bug report #1095890,
regarding manpath.5: 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.)
--
1095890: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1095890
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: man-db
Version: 2.13.0-1
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?
an.tmac:<stdin>:45: misuse, warning: .IR is for at least 2 arguments, got 1
Use macro '.I' for one argument or split argument.
* 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 man-db depends on:
ii bsdextrautils 2.40.4-3
ii bsdmainutils 12.1.8
ii debconf [debconf-2.0] 1.5.89
ii groff-base 1.23.0-7
ii libc6 2.40-6
ii libgdbm6t64 1.24-2
ii libpipeline1 1.5.8-1
ii libseccomp2 2.5.5-2
ii zlib1g 1:1.3.dfsg+really1.3.1-1+b1
man-db recommends no packages.
Versions of packages man-db suggests:
pn apparmor <none>
ii firefox-esr [www-browser] 128.7.0esr-1
ii groff 1.23.0-7
ii less 643-1
ii lynx [www-browser] 2.9.2-1
ii w3m [www-browser] 0.5.3+git20230121-2.1
-- Configuration Files:
/etc/manpath.config changed [not included]
-- debconf information excluded
Input file is manpath.5
Output from "mandoc -T lint manpath.5": (shortened list)
-.-.
Output from "test-groff -mandoc -t -ww -z manpath.5": (shortened list)
1 Use macro '.I' for one argument or split argument.
1 .IR is for at least 2 arguments, got 1
-.-.
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 URLs (web address)
72 .IR /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man .
-.-.
Add a comma (or \&) after "e.g." and "i.e.", or use English words
(man-pages(7)).
Abbreviation points should be protected against being interpreted as
an end of sentence, if they are not, and that independent of the
current place on the line.
208:(e.g. "1 1mh 8 ...").
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
manpath.5:203:If a particular extension is not in this list (say, 1mh) it will
be
manpath.5:217:cat pages will not be created (if missing) or displayed.
manpath.5:223:cat pages will not be created (if missing) or displayed.
-.-.
Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.
13:.TH MANPATH 5 "2024-08-29" "2.13.0" "/etc/manpath.config"
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
an.tmac:<stdin>:45: misuse, warning: .IR is for at least 2 arguments, got 1
Use macro '.I' for one argument or split argument.
--- manpath.5 2025-02-13 10:22:01.696592511 +0000
+++ manpath.5.new 2025-02-13 10:30:06.568965749 +0000
@@ -10,7 +10,7 @@
.\" Sat Oct 29 13:09:31 GMT 1994 Wilf. ([email protected])
.\"
.pc
-.TH MANPATH 5 "2024-08-29" "2.13.0" "/etc/manpath.config"
+.TH MANPATH 5 2024-08-29 2.13.0 /etc/manpath.config
.SH NAME
manpath \- format of the /etc/manpath.config file
.SH DESCRIPTION
@@ -42,7 +42,7 @@ then it adds all of
.IR path_element/man ,
.IR path_element/../share/man ,
and
-.IR path_element/share/man
+.I path_element/share/man
that exist as directories to the search path.
It then adds any
@@ -69,7 +69,7 @@ and
is set to
.IR newOS:man ,
then the final search path will be
-.IR /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man .
+.IR
/usr/share/man/newOS:\:/usr/share/man:\:/usr/local/man/newOS:\:/usr/local/man .
The
.RB $ MANPATH
@@ -200,12 +200,13 @@ If multiple
.B SECTION
directives are given, their section lists will be concatenated.
.PP
-If a particular extension is not in this list (say, 1mh) it will be
-displayed with the rest of the section it belongs to.
+If a particular extension is not in this list
+(say, 1mh)
+it will be displayed with the rest of the section it belongs to.
The effect of this is that you only need to explicitly list extensions if
you want to force a particular order.
Sections with extensions should usually be adjacent to their main section
-(e.g. "1 1mh 8 ...").
+(e.g., "1 1mh 8 ...").
.PP
.B SECTIONS
is accepted as an alternative name for this directive.
@@ -214,13 +215,17 @@ is accepted as an alternative name for t
.BI MINCATWIDTH \ width
If the terminal width is less than
.IR width ,
-cat pages will not be created (if missing) or displayed.
+cat pages will not be created
+(if missing)
+or displayed.
The default is 80.
.TP
.BI MAXCATWIDTH \ width
If the terminal width is greater than
.IR width ,
-cat pages will not be created (if missing) or displayed.
+cat pages will not be created
+(if missing)
+or displayed.
The default is 80.
.TP
.BI CATWIDTH \ width
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 -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: man-db
Source-Version: 2.13.1-1
Done: Colin Watson <[email protected]>
We believe that the bug you reported is fixed in the latest version of
man-db, 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.
Colin Watson <[email protected]> (supplier of updated man-db 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: Fri, 02 May 2025 14:24:27 +0100
Source: man-db
Architecture: source
Version: 2.13.1-1
Distribution: unstable
Urgency: medium
Maintainer: Colin Watson <[email protected]>
Changed-By: Colin Watson <[email protected]>
Closes: 1085485 1093431 1095890 1102453
Changes:
man-db (2.13.1-1) unstable; urgency=medium
.
* Remove /usr/lib/man-db/{man,mandb} compatibility symlinks, obsolete
since 2002.
* New upstream release:
- man(1): Fix minor formatting issues (closes: #1085485).
- Tolerate additional spaces in preprocessor strings (closes: #1093431).
- manpath(5): Fix minor formatting issues (closes: #1095890).
- Increase MAX_NAME to 16384 (closes: #1102453).
Checksums-Sha1:
038596b4dc26dd13ea1201b64564287006c6435f 2550 man-db_2.13.1-1.dsc
f4ca21be6b6b75a83601f7589f57e3e0a57b5e06 2110328 man-db_2.13.1.orig.tar.xz
f0e99a293ddbb8333b331e9d21e6adafde46101c 833 man-db_2.13.1.orig.tar.xz.asc
b974330a2016ccd33209ea59961b847f755d8ad7 75260 man-db_2.13.1-1.debian.tar.xz
Checksums-Sha256:
fef403307d02f4d71f6074c713a2a883d5e17acb6efba1654d2744756f46bcba 2550
man-db_2.13.1-1.dsc
8afebb6f7eb6bb8542929458841f5c7e6f240e30c86358c1fbcefbea076c87d9 2110328
man-db_2.13.1.orig.tar.xz
4c7ff278ae2de1ac858857a9c308629574f6f9c00fc404619afd7f18a850d156 833
man-db_2.13.1.orig.tar.xz.asc
fcde6e90b95bc33218fd65e4bd5ec79a2765bc43ae04f27ae9347deec78091b0 75260
man-db_2.13.1-1.debian.tar.xz
Files:
d0a6d860fbde68e19f9f1fa5cce761bd 2550 doc important man-db_2.13.1-1.dsc
b6335533cbeac3b24cd7be31fdee8c83 2110328 doc important
man-db_2.13.1.orig.tar.xz
91bd3e1993fc4527117e3bcf73959d2f 833 doc important
man-db_2.13.1.orig.tar.xz.asc
54505faf9ec2bef498c2c154c6f7ca8d 75260 doc important
man-db_2.13.1-1.debian.tar.xz
-----BEGIN PGP SIGNATURE-----
iQIzBAEBCgAdFiEErApP8SYRtvzPAcEROTWH2X2GUAsFAmgUx7AACgkQOTWH2X2G
UAtTvxAAgO4aWH6EOSnwZ1+J25hZr3ncLMx8t0aI+ncmNiLismHWtv8Kb6smRnkF
0C9Gdkl52rtzoTy11lqRe/Y6BJqHLBxlnDJ3cMAe8AdVIvrIsqVg+fwnfcdrIyk9
tySUfx9Dy1kmwb7wSPJx3nVZQF9EL3/VsHo7nfMbFSqsxEll0Hbn+rJYZdHI5pnV
ecq5Tr0MwthB+BEVFJ/dYMIQe2k1Z8P8qHlJf0CoBdUhtl2OYBdO3HxRUNuFCzW0
s10GO4OL60HRogX4LVlznrr26rxt59AgCDzuAoKOh0js+Z2Mz/hJ2DRj2C1TK8nu
aX8kEvRRiR2JEnvIHsg87hGWzlZTZurkwwcM0gZO6rC70tz5MFGu3JPVjMb7pVdV
ss/a61uBBb7P2qAuDZuv3CGwDEIZyhsMeFjPKg/yyRGQ/JiZ3MfCy8L3HOhGmoQf
1qKMbNrzMvnmtFO/wYgmnFyqV5yQVpWr4YkdYH25i9m/W/5wrSuBJvinFiN3Nl7J
zCnBybZF8WgULJ0iQIt6RDT4oqRY0MvWfnY6tccb8pUjEElzGChKeWXQc2r9caqh
Wu6wPCLRzNX7QABuzejnrqg+8jegT08cYoN52bWW3/R5XyzJNOQc7BMN0hedtABD
aEHjuUxE9+i6TEn67vXZ7MoCy8dk1VkTg+0AnjGeV1MKAeukSRM=
=3VOc
-----END PGP SIGNATURE-----
pgp9MApzjyUgA.pgp
Description: PGP signature
--- End Message ---
