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 

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


Test nr. 8: Protect a full stop (.) with \&, if it has a blank (white-space) in 
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. (


Test nr. 20: Use a macro to change to the italic font, instead of \fI [1], if
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

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.


  1) man-pages(7) from package \"man-pages\" or
\"\" section 7 or

\"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

480:database caches. If the
1409:30th April 1994 \(en 23rd February 2000: Wilf. (



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
5:.\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.)
6:.\" Copyright (C) 2001, 2002, 2003, 2006, 2007, 2008 Colin Watson.
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.
12:.\" Sat Oct 29 13:09:31 GMT 1994  Wilf. (
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'.
452:.\" Need a \c to make sure we don't get a space where we don't want one
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.
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).
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         
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
+++   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
+.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
-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)
-File formats and conventions eg \fI/etc/passwd\fR
+File formats and conventions e.g.\& \fI/etc/passwd\fR
@@ -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 .
 .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 .
 .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
 .BR \-t ", " \-\-troff
-.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.
-.I groff -mandoc
+.I groff \-mandoc
 .BR groff ,
 this option is passed to
@@ -1177,7 +1180,7 @@ It implies
 .BR \-? ", " \-\-help
 Print a help message and exit.
-.BR \-\-usage
+.B \-\-usage
 Print a short usage message and exit.
 .BR \-V ", " \-\-version
@@ -1229,7 +1232,8 @@ If
 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
 directive in
 .IR /etc/manpath.config .
@@ -1372,12 +1376,12 @@ man-db configuration file.
 .I /usr/share/man
 A global manual page hierarchy.
-.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.
-.I /var/cache/man/index.(bt|db|dir|pag)
+.I /var/cache/man/index.(bt\^|\^db\^|\^dir\^|\^pag)
 compliant global
 .I index
@@ -1399,14 +1403,14 @@ database cache.
 .BR catman (8),
 .BR mandb (8),
 the man-db package manual,
 1990, 1991 \(en Originally written by John W.\& Eaton (
 Dec 23 1992: Rik Faith ( applied bug fixes
 supplied by Willem Kasdorp (
-30th April 1994 \(en 23rd February 2000: Wilf. (
+30th April 1994 \(en 23rd February 2000: Wilf.\& (
 has been developing and maintaining this package
 with the help of a few dedicated people.

Reply via email to