util-linux: Some minor fixes in some manuals
PATCH 1/1 util-linux: Some minor fixes in some manuals
Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z
[ "test-groff" is a developmental version of "groff" ]
Input file is ././misc-utils/kill.1
<./misc-utils/kill.1>:173 (macro BR): only 1 argument, but more are expected
####
Input file is ././misc-utils/lsblk.8
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an-old.tmac':478: macro 'BR'
troff: backtrace: file '<./misc-utils/lsblk.8>':122
troff: <./misc-utils/lsblk.8>:122: warning: trailing space
####
Input file is ././sys-utils/mount.8
an-old.tmac: <./sys-utils/mount.8>:2427 (.RE): warning: extra .RE or .RS is missing before it; "an-RS-open" is 0.
####
Input file is ././sys-utils/unshare.1
<./sys-utils/unshare.1>:176 (macro BR): only 1 argument, but more are expected <./sys-utils/unshare.1>:181 (macro BR): only 1 argument, but more are expected <./sys-utils/unshare.1>:240 (macro BR): only 1 argument, but more are expected <./sys-utils/unshare.1>:246 (macro BR): only 1 argument, but more are expected
####
Input file is ././term-utils/agetty.8
troff: backtrace: file '<./term-utils/agetty.8>':130
troff: <./term-utils/agetty.8>:130: warning: trailing space
####
Input file is ././text-utils/more.1
troff: backtrace: file '<./text-utils/more.1>':91
troff: <./text-utils/more.1>:91: warning: macro 'b' not defined
####
The output from nroff and troff is unchanged, except for the word
"number" in text-utils/more.1, that was missing.
--- misc-utils/kill.1 | 2 +- misc-utils/lsblk.8 | 2 +- sys-utils/mount.8 | 1 - sys-utils/unshare.1 | 8 ++++---- term-utils/agetty.8 | 2 +- text-utils/more.1 | 4 ++-- 6 files changed, 9 insertions(+), 10 deletions(-)
misc-utils/kill.1 +1 -1
@@ -170,7 +170,7 @@ preferred in relation to the .BR kill (1) executable described by this manual. Easiest way to ensure one is executing the executable is to use full path when calling the command, for example: -.BR "/bin/kill --version" +.B "/bin/kill \-\-version" .SH RETURN CODES .B kill has the following return codes:
misc-utils/lsblk.8 +1 -1
@@ -119,7 +119,7 @@ The default is to use tree for the column 'NAME' (see also \fB\-\-tree\fR). The default list of columns may be extended if \fIlist\fP is specified in the format \fI+list\fP (e.g., \fBlsblk \-o +UUID\fP). .TP -.BR \-O , " \-\-output\-all " +.BR \-O , " \-\-output\-all" Output all available columns. .TP .BR \-P , " \-\-pairs"
sys-utils/mount.8 +0 -1
@@ -2424,7 +2424,6 @@ Parity bytes for FEC (default: 2). Optional. Path to pkcs7 signature of root hash hex string. Requires crypt_activate_by_signed_key() from cryptsetup and kernel built with CONFIG_DM_VERITY_VERIFY_ROOTHASH_SIG. For device reuse, signatures have to be either used by all mounts of a device or by none. Optional. -.RE .PP Supported since util-linux v2.35. .PP
sys-utils/unshare.1 +4 -4
@@ -173,12 +173,12 @@ implies creating a new mount namespace since the /proc mount would otherwise mess up existing programs on the system. The new proc filesystem is explicitly mounted as private (with MS_PRIVATE|MS_REC). .TP -.BR \-\-map\-user=\fIuid|name +.BI \-\-map\-user= uid|name Run the program only after the current effective user ID has been mapped to \fIuid\fP. If this option is specified multiple times, the last occurrence takes precedence. This option implies \fB\-\-user\fR. .TP -.BR \-\-map\-group=\fIgid|name +.BI \-\-map\-group= gid|name Run the program only after the current effective group ID has been mapped to \fIgid\fP. If this option is specified multiple times, the last occurrence takes precedence. This option implies \fB\-\-setgroups=deny\fR and \fB\-\-user\fR.
@@ -237,13 +237,13 @@ Set the user ID which will be used in the entered namespace. Set the group ID which will be used in the entered namespace and drop supplementary groups. .TP -.BR "\-\-monotonic \fIoffset" +.BI \-\-monotonic " offset" Set the offset of .B CLOCK_MONOTONIC which will be used in the entered time namespace. This option requires unsharing a time namespace with \fB\-\-time\fP. .TP -.BR "\-\-boottime \fIoffset" +.BI \-\-boottime " offset" Set the offset of .B CLOCK_BOOTTIME which will be used in the entered time namespace. This option requires
term-utils/agetty.8 +1 -1
@@ -127,7 +127,7 @@ messages to be displayed on different terminals. The \-\-show\-issue Display the current issue file (or other) on the current terminal and exit. Use this option to review the current setting, it is not designed for any other -purpose. Note that output may use some default or incomplete information as +purpose. Note that output may use some default or incomplete information as proper output depends on terminal and agetty command line. .TP \-h, \-\-flow\-control
text-utils/more.1 +2 -2
@@ -88,9 +88,9 @@ compatibility. .TP \fB\-n\fR, \fB\-\-lines \fInumber\fR Specify the -.b number +.I number of lines per screenful. The -.b number +.I number argument is a positive decimal integer. The .B \-\-lines option shall override any values obtained from any other source, such as
Signature · 1 line
2.26.2
Quoted 7 lines · Bjarni Ingi Gislason
misc-utils/kill.1 | 2 +- misc-utils/lsblk.8 | 2 +- sys-utils/mount.8 | 1 - sys-utils/unshare.1 | 8 ++++---- term-utils/agetty.8 | 2 +- text-utils/more.1 | 4 ++-- 6 files changed, 9 insertions(+), 10 deletions(-)
Applied, thanks.
Signature · 2 lines
Karel Zak <[email protected]> http://karelzak.blogspot.com