[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[sysvinit-devel] [PATCH] sysvinit/man/*: Fix some warnings from "groff"
From: |
Bjarni Ingi Gislason |
Subject: |
[sysvinit-devel] [PATCH] sysvinit/man/*: Fix some warnings from "groff" |
Date: |
Sat, 16 Feb 2019 01:00:01 +0000 |
User-agent: |
Mutt/1.5.20 (2009-12-10) |
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
- [sysvinit-devel] [PATCH] sysvinit/man/*: Fix some warnings from "groff",
Bjarni Ingi Gislason <=