From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: util-linux@vger.kernel.org
Subject: [PATCH] Subject: docs: remove unnecessary paragraph macros
Date: Fri, 10 Jul 2020 00:12:44 +0000 [thread overview]
Message-ID: <20200710001243.GA30809@rhi.hi.is> (raw)
Remove a second paragraph macro (.TP, .PP) as it does not change the
output (.SS/.PP) or it adds an extra empty line (.TP/.TP)
Warning from "mandoc -Tlint":
mandoc: ./sys-utils/hwclock.8.in:299:2: WARNING: line scope broken: TP breaks TP
mandoc: ./sys-utils/hwclock.8.in:459:2: WARNING: skipping paragraph macro: PP after SS
mandoc: ./sys-utils/hwclock.8.in:543:2: WARNING: skipping paragraph macro: PP after SS
mandoc: ./sys-utils/hwclock.8.in:574:2: WARNING: skipping paragraph macro: PP after SS
mandoc: ./sys-utils/hwclock.8.in:673:2: WARNING: skipping paragraph macro: PP after SS
mandoc: ./sys-utils/hwclock.8.in:721:2: WARNING: skipping paragraph macro: PP after SS
Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
sys-utils/hwclock.8.in | 6 ------
1 file changed, 6 deletions(-)
diff --git a/sys-utils/hwclock.8.in b/sys-utils/hwclock.8.in
index e62b4ad09..84fe4d84f 100644
--- a/sys-utils/hwclock.8.in
+++ b/sys-utils/hwclock.8.in
@@ -297,7 +297,6 @@ another delay is required.
.RE
.
.TP
-.TP
.BR \-D ", " \-\-debug
.RB Use\ \-\-verbose .
.RB The\ \%\-\-debug\ option
@@ -456,7 +455,6 @@ is doing internally.
.SH NOTES
.
.SS Clocks in a Linux System
-.PP
There are two types of date-time clocks:
.PP
.B The Hardware Clock:
@@ -540,7 +538,6 @@ See also
.BR \%settimeofday (2).
.
.SS Hardware Clock Access Methods
-.PP
.B \%hwclock
uses many different ways to get and set Hardware Clock values. The most
normal way is to do I/O to the rtc device special file, which is
@@ -571,7 +568,6 @@ provides it for testing, troubleshooting, and because it may be the
only method available on ISA systems which do not have a working rtc
device driver.
.SS The Adjust Function
-.PP
The Hardware Clock is usually not very accurate. However, much of its
inaccuracy is completely predictable - it gains or loses the same amount
of time every day. This is called systematic drift.
@@ -670,7 +666,6 @@ You can use an adjtime file that was previously used with the
.BR \%clock "(8) program with " \%hwclock .
.
.SS Automatic Hardware Clock Synchronization by the Kernel
-.PP
You should be aware of another way that the Hardware Clock is kept
synchronized in some systems. The Linux kernel has a mode wherein it
copies the System Time to the Hardware Clock every 11 minutes. This mode
@@ -718,7 +713,6 @@ notify the kernel.
should not be used with NTP \%'11\ minute\ mode'.
.
.SS ISA Hardware Clock Century value
-.PP
There is some sort of standard that defines CMOS memory Byte 50 on an ISA
machine as an indicator of what century it is.
.B \%hwclock
--
2.27.0
next reply other threads:[~2020-07-10 0:12 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-07-10 0:12 Bjarni Ingi Gislason [this message]
2020-07-14 8:49 ` [PATCH] Subject: docs: remove unnecessary paragraph macros 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=20200710001243.GA30809@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).