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 <bjarn...@rhi.hi.is> --- 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 (u31b...@pool.informatik.rwth-aachen.de). .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