[PATCH] util-linux: Some minor fixes in some manuals

[PATCH] util-linux: Some minor fixes in some manuals

[Bjarni Ingi Gislason]

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.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 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(-)

diff --git a/misc-utils/kill.1 b/misc-utils/kill.1
index 65872ce19..27258d293 100644
--- a/misc-utils/kill.1
+++ b/misc-utils/kill.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:
diff --git a/misc-utils/lsblk.8 b/misc-utils/lsblk.8
index 416b28298..1b73e6f25 100644
--- a/misc-utils/lsblk.8
+++ b/misc-utils/lsblk.8
@@ -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"
diff --git a/sys-utils/mount.8 b/sys-utils/mount.8
index 54af6c2b1..05117c727 100644
--- a/sys-utils/mount.8
+++ b/sys-utils/mount.8
@@ -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
diff --git a/sys-utils/unshare.1 b/sys-utils/unshare.1
index a58821921..86506ffa3 100644
--- a/sys-utils/unshare.1
+++ b/sys-utils/unshare.1
@@ -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
diff --git a/term-utils/agetty.8 b/term-utils/agetty.8
index fa92df09c..fd6cf4b44 100644
--- a/term-utils/agetty.8
+++ b/term-utils/agetty.8
@@ -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
diff --git a/text-utils/more.1 b/text-utils/more.1
index 2176d5528..4cf445f87 100644
--- a/text-utils/more.1
+++ b/text-utils/more.1
@@ -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
-- 
2.26.2

Re: [PATCH] util-linux: Some minor fixes in some manuals

[Karel Zak]

On Thu, May 14, 2020 at 11:51:29PM +0000, Bjarni Ingi Gislason wrote:
>  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.

-- 
 Karel Zak  <kzak@redhat.com>
 http://karelzak.blogspot.com