util-linux.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
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

             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).