Package: man-db Version: 2.8.5-2 Severity: minor Tags: patch Dear Maintainer,
>From dd4c8c5e80b1a6d11c4867cd322d05cb3a88a592 Mon Sep 17 00:00:00 2001 >From: Bjarni Ingi Gislason <bjarn...@rhi.hi.is> >Date: Sat, 20 Apr 2019 01:11:37 +0000 >Subject: [PATCH] manpath.man1: Correct some typographic mistakes in the manual Summary of changes: Remove space at end of lines. Fix warnings from test-groff. Use \(en for a dash where appropriate. Add ".ft R" after a line with \c ### Details: Input file is manpath.man1 execute mandoc -T lint manpath.man1 mandoc: manpath.man1:7:26: STYLE: whitespace at end of input line mandoc: manpath.man1:16:15: STYLE: whitespace at end of input line mandoc: manpath.man1:23:3: STYLE: whitespace at end of input line mandoc: manpath.man1:25:8: STYLE: whitespace at end of input line mandoc: manpath.man1:28:8: STYLE: whitespace at end of input line mandoc: manpath.man1:29:14: STYLE: whitespace at end of input line mandoc: manpath.man1:46:43: STYLE: whitespace at end of input line mandoc: manpath.man1:52:27: STYLE: whitespace at end of input line mandoc: manpath.man1:61:8: STYLE: whitespace at end of input line mandoc: manpath.man1:62:13: STYLE: whitespace at end of input line mandoc: manpath.man1:64:27: STYLE: whitespace at end of input line mandoc: manpath.man1:67:74: STYLE: whitespace at end of input line mandoc: manpath.man1:77:66: STYLE: whitespace at end of input line mandoc: manpath.man1:106:3: STYLE: whitespace at end of input line ####### Enable and fix warnings from 'test-groff'. <manpath.man1>:93 (macro BR): only 1 argument, but more are expected Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z [ "test-groff" is a developmental version of "groff" ] #### Use \(en for a dash (en-dash) between space characters, not a minus (\-) or a hyphen (-), except in the NAME section. 34:man-db configuration file - ##### The single-font macros in groff now use the '.itc' request. Add '.ft R' after a '\c' or use a two font macro. .I system\c \|[\|,.\|.\|.\|]\|, Signed-off-by: Bjarni Ingi Gislason <bjarn...@rhi.hi.is> --- man/man1/manpath.man1 | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/man/man1/manpath.man1 b/man/man1/manpath.man1 index 9b9b8408..cfe9080e 100644 --- a/man/man1/manpath.man1 +++ b/man/man1/manpath.man1 @@ -4,7 +4,7 @@ .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the COPYING file that comes with the -.\" man-db distribution. +.\" man-db distribution. .\" .\" Sun Jan 22 22:15:17 GMT 1995 Wilf. (g.wilf...@ee.surrey.ac.uk) .\" @@ -13,25 +13,25 @@ .SH NAME %manpath% \- determine search path for manual pages .SH SYNOPSIS -.B %manpath% +.B %manpath% .RB [\| \-qgdc?V \|] .RB [\| \-m .IR system \|[\|,.\|.\|.\|]\|] .RB [\| \-C .IR file \|] .SH DESCRIPTION -If +If .RB $ MANPATH -is set, +is set, .B %manpath% will simply display its contents and issue a warning. -If not, -.B %manpath% +If not, +.B %manpath% will determine a suitable manual page hierarchy search path and display the results. The colon-delimited path is determined using information gained from the -man-db configuration file - +man-db configuration file \(en .RI ( "%manpath_config_file%" ) and the user's environment. .SH OPTIONS @@ -43,13 +43,13 @@ Do not issue warnings. Print debugging information. .TP .if !'po4a'hide' .BR \-c ", " \-\-catpath -Produce a catpath as opposed to a manpath. +Produce a catpath as opposed to a manpath. Once the manpath is determined, each path element is converted to its relative catpath. .TP .if !'po4a'hide' .BR \-g ", " \-\-global Produce a manpath consisting of all paths named as `global' within the -man-db configuration file. +man-db configuration file. .\" .\" Due to the rather silly limit of 6 args per request in some `native' .\" *roff compilers, we have do the following to get the two-line @@ -58,13 +58,14 @@ man-db configuration file. .\" (end relative indent). .\" .PP -.B \-m -.I system\c +.B \-m +.I system\c +.ft R \|[\|,.\|.\|.\|]\|, -.BI \-\-systems= system\c +.BI \-\-systems= system\c \|[\|,.\|.\|.\|] .RS -If this system has access to other operating system's manual hierarchies, +If this system has access to other operating system's manual hierarchies, this option can be used to include them in the output of .BR %manpath% . To include NewOS's manual page hierarchies use the option @@ -74,7 +75,7 @@ To include NewOS's manual page hierarchies use the option The .I system specified can be a combination of comma delimited operating system names. -To include the native operating system's manual page hierarchies, +To include the native operating system's manual page hierarchies, the system name .B man must be included in the argument string. @@ -90,7 +91,7 @@ Use this user configuration file rather than the default of .if !'po4a'hide' .BR \-? ", " \-\-help Print a help message and exit. .TP -.if !'po4a'hide' .BR \-\-usage +.if !'po4a'hide' .B \-\-usage Print a short usage message and exit. .TP .if !'po4a'hide' .BR \-V ", " \-\-version @@ -103,7 +104,7 @@ If is set, .B %manpath% displays its value rather than determining it on the fly. -If +If .RB $ MANPATH is prefixed by a colon, then the value of the variable is appended to the list determined from the content of the configuration files. -- 2.20.1 -- System Information: Debian Release: buster/sid APT prefers testing-proposed-updates APT policy: (500, 'testing-proposed-updates'), (500, 'unstable'), (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Kernel: Linux 4.19.28-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+b1 ii debconf [debconf-2.0] 1.5.71 ii dpkg 1.19.6 ii groff-base 1.22.4-3 ii libc6 2.28-8 ii libgdbm6 1.18.1-4 ii libpipeline1 1.5.1-2 ii libseccomp2 2.3.3-4 ii zlib1g 1:1.2.11.dfsg-1 man-db recommends no packages. Versions of packages man-db suggests: pn apparmor <none> ii firefox-esr [www-browser] 60.6.1esr-1 ii groff 1.22.4-3 ii less 487-0.1+b1 ii lynx [www-browser] 2.8.9rel.1-3 ii w3m [www-browser] 0.5.3-37 -- debconf information excluded -- Bjarni I. Gislason
