[sysvinit-devel] [PATCH] sysvinit/man/*: Fix some warnings from "groff"

[Bjarni Ingi Gislason]

  Use a single-font-style macro (".B", ".I") for a single argument.

  Fix other warnings from groff (developmental version)

  Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z

####

<init.8>:254 (macro BI): only 1 argument, but more are expected
troff: <init.8>:279: warning: can't find font '\'
<init.8>:347 (macro BR): only 1 argument, but more are expected

####

an-old.tmac: <initctl.5>:119 (.RE): warning: extra .RE or .RS is missing before 
it; "an-RS-open" is 0.

an-old.tmac: <initctl.5>:143 (.RE): warning: extra .RE or .RS is missing before 
it; "an-RS-open" is 0.

####

an-old.tmac: <initscript.5>:65 (.RE): warning: extra .RE or .RS is missing 
before it; "an-RS-open" is 0.

####

<killall5.8>:23 (macro RB): only 1 argument, but more are expected
<killall5.8>:25 (macro IR): only 1 argument, but more are expected

####

<last.1>:31 (macro RB): only 1 argument, but more are expected
<last.1>:33 (macro RB): only 1 argument, but more are expected
<last.1>:34 (macro RB): only 1 argument, but more are expected
<last.1>:41 (macro RB): only 1 argument, but more are expected
<last.1>:42 (macro RB): only 1 argument, but more are expected

####

<mountpoint.1>:28 (macro RB): only 1 argument, but more are expected

####

<readbootlog.1>:30 (macro RB): only 1 argument, but more are expected

####

<wall.1>:53: backtrace
.../tmac/an-old.tmac:503: backtrace: macro 'IP'
troff: <wall.1>:53: warning: can't find font 'n'

Signed-off-by: Bjarni Ingi Gislason <address@hidden>
---
 man/init.8        |  6 +++---
 man/initctl.5     |  2 --
 man/initscript.5  |  1 -
 man/killall5.8    |  6 +++---
 man/last.1        | 10 +++++-----
 man/mountpoint.1  |  2 +-
 man/readbootlog.1 |  2 +-
 man/wall.1        |  2 +-
 8 files changed, 14 insertions(+), 17 deletions(-)

diff --git a/man/init.8 b/man/init.8
index cbfbf07..b158371 100644
--- a/man/init.8
+++ b/man/init.8
@@ -251,7 +251,7 @@ can then manipulate the command line so that \fBps\fP(1) 
shows
 the current runlevel.
 .PP
 .TP 0.5i
-.BI "--version "
+.B \-\-version
 This argument, when used on its own, displays the current version of init
 to the console/stdout. It is a quick way to determine which init software and
 version is being used. After the version information is displayed, init
@@ -276,7 +276,7 @@ On receipt of this signals, init closes and re-opens its 
control fifo,
 .TP 0.5i
 .B SIGUSR2
 When init receives SIGUSR2, init closes and leaves the control fifo,
-\fB/run/initctl\f\P, closed. This may be used to make sure init is not
+\fB/run/initctl\fP, closed. This may be used to make sure init is not
 holding open any files. However, it also prevents init from switching
 runlevels. Which means commands like shutdown no longer work.
 The fifo can be re-opened by sending init the SIGUSR1 signal.
@@ -344,7 +344,7 @@ page by Michael Haardt (address@hidden).
 .BR login (1),
 .BR sh (1),
 .BR runlevel (8),
-.BR shutdown(8),
+.BR shutdown (8),
 .BR kill (1),
 .BR initctl (5),
 .BR inittab (5),
diff --git a/man/initctl.5 b/man/initctl.5
index f736c23..5985df9 100644
--- a/man/initctl.5
+++ b/man/initctl.5
@@ -116,7 +116,6 @@ if ((fd = open(INIT_FIFO, O_WRONLY)) >= 0) /* open pipe for 
writing */
 .fi
 
 .sp
-.RE
 .SH NOTES
 Usually the /run/initctl pipe would only be used by low-level programs to
 request a power-related shutdown or change the runlevel, like telinit
@@ -140,7 +139,6 @@ the SIGUSR1 signal.
 If the /run/initctl pipe is closed then it may still be possible to bring
 down the system using the shutdown command's -n flag, but this is not
 always clean and not recommended.
-.RE
 .SH FILES
 /run/initctl
 /sbin/init
diff --git a/man/initscript.5 b/man/initscript.5
index 875879c..a20a88f 100644
--- a/man/initscript.5
+++ b/man/initscript.5
@@ -62,7 +62,6 @@ This script is not meant as startup script for daemons or 
somesuch.
 It has nothing to do with a \fIrc.local\fP style script. It's just
 a handler for things executed from \fB/etc/inittab\fP. Experimenting
 with this can make your system un(re)bootable.
-.RE
 .SH FILES
 /etc/inittab,
 /etc/initscript.
diff --git a/man/killall5.8 b/man/killall5.8
index ac3cc09..29b53f1 100644
--- a/man/killall5.8
+++ b/man/killall5.8
@@ -20,11 +20,11 @@
 killall5 -- send a signal to all processes.
 .SH SYNOPSIS
 .B killall5
-.RB -signalnumber
+.B \-signalnumber
 .RB [ \-o
-.IR omitpid[,omitpid...]]
+.IR omitpid [, omitpid ...]]
 .RB [ \-o
-.IR omitpid[,omitpid...]... ]
+.IR omitpid [, omitpid ...]...]
 .SH DESCRIPTION
 .B killall5
 is the SystemV killall command. It sends a signal to all processes except
diff --git a/man/last.1 b/man/last.1
index c57743c..c886b93 100644
--- a/man/last.1
+++ b/man/last.1
@@ -28,18 +28,18 @@ last, lastb \- show listing of last logged in users
 .B last
 .RB [ \-R ]
 .RB [ \-\fInum\fP ]
-.RB "[ \-\fBn\fP \fInum\fP ]"
+[\-\fBn\fP \fInum\/\fP]
 .RB [ \-adFiowx ]
-.RB "[ \-\fBf\fP \fIfile\fP ]"
-.RB "[ \-\fBt\fP \fIYYYYMMDDHHMMSS\fP ]"
+[\-\fBf\fP \fIfile\/\fP]
+[\-\fBt\fP \fIYYYYMMDDHHMMSS\/\fP]
 .RI [ name... ]
 .RI [ tty... ]
 .br
 .B lastb
 .RB [ \-R ]
 .RB [ \-\fInum\fP ]
-.RB "[ \-\fBn\fP \fInum\fP ]"
-.RB "[ \-\fBf\fP \fIfile\fP ]"
+[\-\fBn\fP \fInum\/\fP]
+[\-\fBf\fP \fIfile\/\fP]
 .RB [ \-adFiowx ]
 .RI [ name... ]
 .RI [ tty... ]
diff --git a/man/mountpoint.1 b/man/mountpoint.1
index 992c9f5..7b4e4ab 100644
--- a/man/mountpoint.1
+++ b/man/mountpoint.1
@@ -25,7 +25,7 @@ mountpoint \- see if a directory is a mountpoint
 .I /path/to/directory
 .br
 .B /bin/mountpoint
-.RB \-x
+.B \-x
 .I /dev/device
 .SH DESCRIPTION
 \fBMountpoint\fP checks if the directory is a mountpoint.
diff --git a/man/readbootlog.1 b/man/readbootlog.1
index c95369b..fc8844c 100644
--- a/man/readbootlog.1
+++ b/man/readbootlog.1
@@ -27,7 +27,7 @@ readbootlog \- show contents of the boot log, stripping away 
control characters
 .SH SYNOPSIS
 .B readbootlog
 .RB [ \-h ]
-.RB "[ \-\fBf\fP \fIfile\fP ]"
+[\-\fBf\fP \fIfile\/\fP]
 .br
 .\"}}}
 .\"{{{  Description
diff --git a/man/wall.1 b/man/wall.1
index 2fe8301..df37d73 100644
--- a/man/wall.1
+++ b/man/wall.1
@@ -50,7 +50,7 @@ and level
 .BR LOG_INFO .
 
 .SH OPTIONS
-.IP \fB\-n\fn
+.IP \fB\-n\fP
 Suppresses the normal banner printed by
 .IR wall ,
 changing it to "Remote broadcast message".
-- 
2.20.1