linux-man.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: mtk.manpages@gmail.com
Cc: linux-man@vger.kernel.org
Subject: [PATCH] man5/*: srcfix, fix warnings from "mandoc -Tlint"
Date: Sun, 21 Jun 2020 00:07:13 +0000	[thread overview]
Message-ID: <20200621000713.GA10250@rhi.hi.is> (raw)

  Remove superfluous paragraph macros.

  The output from "nroff" and "groff" is unchanged.

###

  Some examples of warnings:

mandoc: core.5:576:2: WARNING: skipping paragraph macro: PP empty

mandoc: elf.5:564:2: WARNING: skipping paragraph macro: IP empty

mandoc: utmp.5:229:2: WARNING: skipping paragraph macro: PP after SH

###

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 man5/core.5     | 1 -
 man5/elf.5      | 3 ---
 man5/locale.5   | 2 --
 man5/networks.5 | 1 -
 man5/proc.5     | 3 ---
 man5/utmp.5     | 2 --
 6 files changed, 12 deletions(-)

diff --git a/man5/core.5 b/man5/core.5
index 53d173a0c..458a84ee9 100644
--- a/man5/core.5
+++ b/man5/core.5
@@ -573,7 +573,6 @@ as well as the number of the signal which triggered the core dump):
 # \fBsysctl \-w kernel.core_pattern="%e\-%s.core"\fP
 .EE
 .in
-.PP
 .\"
 .SH NOTES
 The
diff --git a/man5/elf.5 b/man5/elf.5
index 3be909870..eb84ab3c8 100644
--- a/man5/elf.5
+++ b/man5/elf.5
@@ -561,7 +561,6 @@ This is defined as 0xffff, the largest number
 can have, specifying where the actual number of program headers is assigned.
 .PD
 .RE
-.IP
 .TP
 .I e_shentsize
 This member holds a sections header's size in bytes.
@@ -2129,7 +2128,6 @@ A version string of some sort.
 Architecture information.
 .PD
 .RE
-.PP
 .RE
 .SH NOTES
 .\" OpenBSD
@@ -2190,4 +2188,3 @@ Sun Microsystems,
 .PP
 AMD64 ABI Draft,
 .IR "System V Application Binary Interface AMD64 Architecture Processor Supplement" .
-.PP
diff --git a/man5/locale.5 b/man5/locale.5
index be1308b6e..d63488b87 100644
--- a/man5/locale.5
+++ b/man5/locale.5
@@ -104,7 +104,6 @@ the GNU C library supports the following nonstandard categories:
 See
 .BR locale (7)
 for a more detailed description of each category.
-.PP
 .SS LC_ADDRESS
 The definition starts with the string
 .I LC_ADDRESS
@@ -1125,7 +1124,6 @@ Each string has the following format:
 .IR direction ":" offset ":" start_date ":" end_date ":" era_name ":" era_format
 .PP
 The fields are to be defined as follows:
-.PP
 .TP 4
 .I direction
 Either
diff --git a/man5/networks.5 b/man5/networks.5
index 75ad20fc9..b85dac3e0 100644
--- a/man5/networks.5
+++ b/man5/networks.5
@@ -59,7 +59,6 @@ The trailing ".0" (for the host component of the network address) may be omitted
 .I aliases
 Optional aliases for the network.
 .PP
-.PP
 This file is read by the
 .BR route (8)
 and
diff --git a/man5/proc.5 b/man5/proc.5
index 6645a1ae8..45c921b49 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -2080,7 +2080,6 @@ check (refer to
 .BR ptrace (2)).
 If the check denies access, then the field value is displayed as 0.
 The affected fields are indicated with the marking [PT].
-.IP
 .RS
 .TP 10
 (1) \fIpid\fP \ %d
@@ -2826,7 +2825,6 @@ In a multithreaded process, the contents of the
 directory are not available if the main thread has already terminated
 (typically by calling
 .BR pthread_exit (3)).
-.IP
 .TP
 .IR /proc/[pid]/task/[tid]/children " (since Linux 3.5)"
 .\" commit 818411616baf46ceba0cff6f05af3a9b294734f7
@@ -3984,7 +3982,6 @@ sl  local_address rem_address   st tx_queue rx_queue tr rexmits  tm\->when uid
  1: 00000000:0201 00000000:0000 0A 00000000:00000000 00:00000000 00000000 0
 .EE
 .in
-.IP
 .TP
 .I /proc/net/unix
 Lists the UNIX domain sockets present within the system and their
diff --git a/man5/utmp.5 b/man5/utmp.5
index 425e805d0..2ed616761 100644
--- a/man5/utmp.5
+++ b/man5/utmp.5
@@ -226,7 +226,6 @@ removed, record-keeping is turned off.
 .br
 .I /var/log/wtmp
 .SH CONFORMING TO
-.PP
 POSIX.1 does not specify a
 .I utmp
 structure, but rather one named
@@ -278,7 +277,6 @@ Linux uses the BSD conventions for line contents, as documented above.
 .\" informative messages such as \fB"new time"\fP in the line field.
 System V has no \fIut_host\fP or \fIut_addr_v6\fP fields.
 .SH NOTES
-.PP
 Unlike various other
 systems, where utmp logging can be disabled by removing the file, utmp
 must always exist on Linux.
-- 
2.27.0

             reply	other threads:[~2020-06-21  0:07 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-06-21  0:07 Bjarni Ingi Gislason [this message]
2020-06-21  7:25 ` [PATCH] man5/*: srcfix, fix warnings from "mandoc -Tlint" Michael Kerrisk (man-pages)

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=20200621000713.GA10250@rhi.hi.is \
    --to=bjarniig@rhi.hi.is \
    --cc=linux-man@vger.kernel.org \
    --cc=mtk.manpages@gmail.com \
    /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).