From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: util-linux@vger.kernel.org
Subject: [PATCH] man pages: Fix misuse of two-fonts-macros (BR, IR)
Date: Sun, 5 Aug 2018 22:05:48 +0000 [thread overview]
Message-ID: <20180805220548.GA32181@rhi.hi.is> (raw)
Change a two-fonts-macro to the single font one, when there is only
one genuine argument.
Split a punctuation mark from the only argument to a two-fonts-marco.
Remove an isolated two-fonts-macro.
Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
Warning from "test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z"
[ "test-groff" is a developmental version of "groff" ]
Input file is ././sys-utils/hwclock.8.in
<./sys-utils/hwclock.8.in>:196 (macro BR): only 1 argument, but more are expected
<./sys-utils/hwclock.8.in>:827 (macro RB): only 1 argument, but more are expected
####
Input file is ././sys-utils/lscpu.1
<./sys-utils/lscpu.1>:128 (macro BR): only 0 argument, but more are expected
####
Input file is ././sys-utils/mount.8
<./sys-utils/mount.8>:242 (macro IR): only 1 argument, but more are expected
<./sys-utils/mount.8>:658 (macro BR): only 1 argument, but more are expected
<./sys-utils/mount.8>:661 (macro BR): only 1 argument, but more are expected
####
Input file is ././sys-utils/rtcwake.8.in
<./sys-utils/rtcwake.8.in>:52 (macro BR): only 1 argument, but more are expected
####
Input file is ././sys-utils/umount.8
<./sys-utils/umount.8>:138 (macro BR): only 1 argument, but more are expected
<./sys-utils/umount.8>:141 (macro BR): only 1 argument, but more are expected
<./sys-utils/umount.8>:179 (macro BR): only 0 argument, but more are expected
####
sys-utils/hwclock.8.in | 4 ++--
sys-utils/lscpu.1 | 1 -
sys-utils/mount.8 | 6 +++---
sys-utils/rtcwake.8.in | 2 +-
sys-utils/umount.8 | 5 ++---
5 files changed, 8 insertions(+), 10 deletions(-)
diff --git a/sys-utils/hwclock.8.in b/sys-utils/hwclock.8.in
index bef7a3170..dacdd272f 100644
--- a/sys-utils/hwclock.8.in
+++ b/sys-utils/hwclock.8.in
@@ -193,7 +193,7 @@ the Hardware Clock while its Linux instance is not running.
.TP
.B \-\-set
Set the Hardware Clock to the time given by the
-.BR \-\-date
+.B \-\-date
option, and update the timestamps in
.IR @ADJTIME_PATH@ .
With the
@@ -824,7 +824,7 @@ cold drift should yield better results.
.PP
.B Steps to calculate cold drift:
.IP 1 2
-.RB "Ensure that NTP daemon will not be launched at startup."
+.B "Ensure that NTP daemon will not be launched at startup."
.IP 2 2
.RI The " System Clock " "time must be correct at shutdown!"
.IP 3 2
diff --git a/sys-utils/lscpu.1 b/sys-utils/lscpu.1
index fa7a475ba..23dee9b42 100644
--- a/sys-utils/lscpu.1
+++ b/sys-utils/lscpu.1
@@ -125,7 +125,6 @@ Display help text and exit.
.TP
.BR \-J , " \-\-json"
Use JSON output format for the default summary or extended output (see \fB\-\-extended\fP).
-.BR
.TP
.BR \-p , " \-\-parse" [=\fIlist\fP]
Optimize the command output for easy parsing.
diff --git a/sys-utils/mount.8 b/sys-utils/mount.8
index a04a11a67..c503987e8 100644
--- a/sys-utils/mount.8
+++ b/sys-utils/mount.8
@@ -239,7 +239,7 @@ and
traditionally maintained a list of currently mounted filesystems in the file
.IR /etc/mtab .
The support for regular classic
-.IR /etc/mtab
+.I /etc/mtab
is completely disabled in compile time by default, because on current Linux
systems it is better to make it a symlink to
.I /proc/mounts
@@ -655,10 +655,10 @@ or special file representing that namespace.
.sp
.BR mount (8)
switches to the namespace when it reads /etc/fstab, writes /etc/mtab (or writes to /run/mount) and calls
-.BR mount(2)
+.BR mount (2)
system call, otherwise it runs in the original namespace. It means that the target namespace does not have
to contain any libraries or another requirements necessary to execute
-.BR mount(2)
+.BR mount (2)
command.
.sp
See \fBnamespaces\fR(7) for more information.
diff --git a/sys-utils/rtcwake.8.in b/sys-utils/rtcwake.8.in
index 9aaca6d79..167f7f9d1 100644
--- a/sys-utils/rtcwake.8.in
+++ b/sys-utils/rtcwake.8.in
@@ -49,7 +49,7 @@ an alarm up to 24 hours in the future.
The suspend setup maybe be interrupted by active hardware; for example wireless USB
input devices that continue to send events for some fraction of a second after the
return key is pressed.
-.BR rtcwake
+.B rtcwake
tries to avoid this problem and it waits to terminal to settle down before
entering a system sleep.
diff --git a/sys-utils/umount.8 b/sys-utils/umount.8
index 136f6179c..eb2e65dd7 100644
--- a/sys-utils/umount.8
+++ b/sys-utils/umount.8
@@ -135,10 +135,10 @@ or special file representing that namespace.
.sp
.BR umount (8)
switches to the namespace when it reads /etc/fstab, writes /etc/mtab (or writes to /run/mount) and calls
-.BR umount(2)
+.BR umount (2)
system call, otherwise it runs in the original namespace. It means that the target namespace does not have
to contain any libraries or another requirements necessary to execute
-.BR umount(2)
+.BR umount (2)
command.
.sp
See \fBnamespaces\fR(7) for more information.
@@ -176,7 +176,6 @@ More than one type may be specified in a comma-separated list. The list
of filesystem types can be prefixed with
.B no
to indicate that no action should be taken for all of the mentioned types.
-.BR
Note that
.B umount
reads information about mounted filesystems from kernel (/proc/mounts) and
--
2.18.0
--
Bjarni I. Gislason
next reply other threads:[~2018-08-06 0:11 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-08-05 22:05 Bjarni Ingi Gislason [this message]
2018-08-06 7:03 ` [PATCH] man pages: Fix misuse of two-fonts-macros (BR, IR) Karel Zak
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180805220548.GA32181@rhi.hi.is \
--to=bjarniig@rhi.hi.is \
--cc=util-linux@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).