Package: man-db
Version: 2.8.2-1
Severity: minor
Tags: patch
Dear Maintainer,
Input file is man.1
Test nr. 1: Remove space at end of lines to simplify other automatic tests to
improve
typesetting.
173:directive in
#####
Test nr. 2: Enable and fix warnings from 'test-groff'.
Input file is /tmp/man.1
<standard input>:169 (macro IR): only 1 argument, but more are expected
<standard input>:330 (macro BR): only 1 argument, but more are expected
<standard input>:916 (macro IR): only 1 argument, but more are expected
<standard input>:1180 (macro BR): only 1 argument, but more are expected
<standard input>:1402 (macro BR): only 1 argument, but more are expected
chk_manuals: Output is from: test-groff -Tutf8 -b -e -mandoc -rF0 -t -w w -z
Test nr. 15: Change the name of a macro for two fonts (e.g., BR and IR) to
one letter,
if there is only one argument.
Add the second argument if needed. It is sometimes part of the first one.
169:.IR sections
330:.BR dvips.
916:.IR x
1180:.BR \-\-usage
1402:.BR FSSTND
#####
Test nr. 8: Protect a full stop (.) with \&, if it has a blank (white-space) in
front
of or (ignoring transparent characters to the full stop) after it, and it does
not mean an end of a sentence.
1409:30th April 1994 \(en 23rd February 2000: Wilf. (g.wilf...@ee.surrey.ac.uk)
#####
Test nr. 20: Use a macro to change to the italic font, instead of \fI [1], if
possible.
The macros have the italic corrections.
[1] man-pages(7)
291:from section \fI7\fR.
#####
Test nr. 24:
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.
1110:.I groff -mandoc
1167:.I groff -mandoc
#####
Test nr. 27: Split lines longer than 80 characters into two or more
lines.
man.1: line 170 length 108
man.1: line 1232 length 85
#####
Test nr. 28: The "indicator" is an "end-of-sentence character" (.!?).
The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line to avoid different
writers' conventions.
References:
1) man-pages(7) from package \"man-pages\" or
\"www.kernel.org/doc/man-pages\" section 7 or
\"man7.org/linux/man-pages/man7/man-pages.7.html\":
\"New sentences should be started on new lines.
This makes it easier to see the effect of patches,
which often operate at the level of individual sentences.\"
2) groff_diff(7) in package \"groff\":
\"In GNU troff, as in UNIX troff, you should always follow a sentence
with either a newline or two spaces.\"
3) \"info groff\":
Search for the word \"sentence\" in the output to get more hints about input
conventions.
480:database caches. If the
1409:30th April 1994 \(en 23rd February 2000: Wilf. (g.wilf...@ee.surrey.ac.uk)
#####
NO PATCH
Test nr. 30: Surround a block of comments with the macros ".ig" and "..".
The .\" at the beginning of each line is then not needed.
Makes it easier to add and remove text and adjust lenght of lines
2:.\" ** The above line should force tbl to be a preprocessor **
3:.\" Man page for man
4:.\"
5:.\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.)
6:.\" Copyright (C) 2001, 2002, 2003, 2006, 2007, 2008 Colin Watson.
7:.\"
8:.\" You may distribute under the terms of the GNU General Public
9:.\" License as specified in the file COPYING that comes with the
10:.\" man-db distribution.
11:.\"
12:.\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (g.wilf...@ee.surrey.ac.uk)
13:.\"
19:.\" The general command line
66:.\" The apropos command line
74:.\" The --global-apropos command line
85:.\" The whatis command line
93:.\" The --local command line
126:.\" The --where/--where-cat command line
136:.\" The --catman command line
146:.\" --help and --version
414:.\"`User' manual page hierarchies will have
415:.\".B index
416:.\"caches created `on the fly'.
451:.\"
452:.\" Need a \c to make sure we don't get a space where we don't want one
453:.\"
557:.\" ********************************************************************
635:.\" Compressed nroff source files with a supported compression
636:.\" extension will be decompressed by man prior to being displaying via the
637:.\" usual filters.
688:.\"
689:.\" Due to the rather silly limit of 6 args per request in some `native'
690:.\" *roff compilers, we have do the following to get the two-line
691:.\" hanging tag on one line. .PP to begin a new paragraph, then the
692:.\" tag, then .RS (start relative indent), the text, finally .RE
693:.\" (end relative indent).
694:.\"
918:.\"The default options are
919:.\".BR \-six8 .
923:.\"The actual default will depend on your chosen
924:.\".BR locale .
929:.\"You may need to do this if your
930:.\"version of
931:.\".B less
932:.\"rejects the default options or if you prefer a different prompt.
1202:.\".TP \w'MANROFFSEQ\ \ 'u
#####
Test nr. 35: Add a space around "|" to increases readability
1375:.I /usr/share/man/index.(bt|db|dir|pag)
1380:.I /var/cache/man/index.(bt|db|dir|pag)
#####
The patch is in the attachment.
-- System Information:
Debian Release: buster/sid
APT prefers stable-updates
APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500,
'testing'), (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 4.9.80-2 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages man-db depends on:
ii bsdmainutils 11.1.2
ii debconf [debconf-2.0] 1.5.66
ii dpkg 1.19.0.5
ii groff-base 1.22.3-10
ii libc6 2.26-6
ii libgdbm5 1.14.1-4
ii libpipeline1 1.5.0-1
ii libseccomp2 2.3.1-2.1
ii zlib1g 1:1.2.8.dfsg-5
man-db recommends no packages.
Versions of packages man-db suggests:
pn apparmor <none>
ii firefox-esr [www-browser] 52.6.0esr-2+b1
ii groff 1.22.3-10
ii less 487-0.1
ii lynx [www-browser] 2.8.9dev16-3
ii w3m [www-browser] 0.5.3-36
-- debconf information:
man-db/auto-update: true
man-db/install-setuid: false
--
Bjarni I. Gislason
--- man.1 2018-02-28 15:04:14.000000000 +0000
+++ man.1.new 2018-03-07 00:11:23.000000000 +0000
@@ -166,11 +166,12 @@ to look only in that
.I section
of the manual.
The default action is to search in all of the available
-.IR sections
-following a pre-defined order ("1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7" by
default, unless overridden by
-the
+.I sections
+following a pre-defined order ("1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9
+6 7" by default,
+unless overridden by the
.B SECTION
-directive in
+directive in
.IR /etc/manpath.config ),
and to show only the first
.I page
@@ -199,7 +200,7 @@ T}
Special files (usually found in \fI/dev\/\fR)
T}
5@T{
-File formats and conventions eg \fI/etc/passwd\fR
+File formats and conventions e.g.\& \fI/etc/passwd\fR
T}
6@T{
Games
@@ -288,7 +289,8 @@ Display the manual page for the
\fBman \fIman\fR.\fI7
Display the manual page for macro package
.I man
-from section \fI7\fR.
+from section
+.IR 7 .
.TP
.BI man\ \-a \ intro
Display, in succession, all of the available
@@ -327,7 +329,7 @@ with no pager.
The output could be viewed with a program such as
.B xdvi
or further processed into PostScript using a program such as
-.BR dvips.
+.BR dvips .
.TP
.BI man\ \-k \ printf
Search the short descriptions and manual page names for the keyword
@@ -477,7 +479,8 @@ manual pager, please read the documents
.B man
will search for the desired manual pages within the
.I index
-database caches. If the
+database caches.
+If the
.B \-u
option is given, a cache consistency check is performed to ensure the
databases accurately reflect the filesystem.
@@ -913,7 +916,7 @@ where
denotes the manual page name,
.I sec
denotes the section it was found under and
-.IR x
+.I x
the current line number.
.\"The default options are
.\".BR \-six8 .
@@ -1107,7 +1110,7 @@ is always run as the very first preproce
.TP
.BR \-t ", " \-\-troff
Use
-.I groff -mandoc
+.I groff \-mandoc
to format the manual page to stdout.
This option is not required in conjunction with
.BR \-H ,
@@ -1164,7 +1167,7 @@ will run
and then use an appropriate post-processor to produce output suitable for
the chosen device.
If
-.I groff -mandoc
+.I groff \-mandoc
is
.BR groff ,
this option is passed to
@@ -1177,7 +1180,7 @@ It implies
.BR \-? ", " \-\-help
Print a help message and exit.
.TP
-.BR \-\-usage
+.B \-\-usage
Print a short usage message and exit.
.TP
.BR \-V ", " \-\-version
@@ -1229,7 +1232,8 @@ If
.RB $ MANSECT
is set, its value is a colon-delimited list of sections and it is used to
determine which manual sections to search and in what order.
-The default is "1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7", unless overridden
by the
+The default is "1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7",
+unless overridden by the
.B SECTION
directive in
.IR /etc/manpath.config .
@@ -1372,12 +1376,12 @@ man-db configuration file.
.I /usr/share/man
A global manual page hierarchy.
.TP
-.I /usr/share/man/index.(bt|db|dir|pag)
+.I /usr/share/man/index.(bt\^|\^db\^|\^dir\^|\^pag)
A traditional global
.I index
database cache.
.TP
-.I /var/cache/man/index.(bt|db|dir|pag)
+.I /var/cache/man/index.(bt\^|\^db\^|\^dir\^|\^pag)
An FHS
compliant global
.I index
@@ -1399,14 +1403,14 @@ database cache.
.BR catman (8),
.BR mandb (8),
the man-db package manual,
-.BR FSSTND
+.B FSSTND
.SH HISTORY
1990, 1991 \(en Originally written by John W.\& Eaton (j...@che.utexas.edu).
Dec 23 1992: Rik Faith (fa...@cs.unc.edu) applied bug fixes
supplied by Willem Kasdorp (wka...@nikhefk.nikef.nl).
-30th April 1994 \(en 23rd February 2000: Wilf. (g.wilf...@ee.surrey.ac.uk)
+30th April 1994 \(en 23rd February 2000: Wilf.\& (g.wilf...@ee.surrey.ac.uk)
has been developing and maintaining this package
with the help of a few dedicated people.
