[PATCH] man4/*: srcfix, fix warnings from "mandoc -Tlint"

* [PATCH] man4/*: srcfix, fix warnings from "mandoc -Tlint"
@ 2020-06-20 23:36 Bjarni Ingi Gislason
  2020-06-21  7:25 ` Michael Kerrisk (man-pages)
  0 siblings, 1 reply; 2+ messages in thread
From: Bjarni Ingi Gislason @ 2020-06-20 23:36 UTC (permalink / raw)
  To: mtk.manpages; +Cc: linux-man

  Remove superfluous paragraph macros.

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

###

  Examples of warnings:

mandoc: fuse.4:244:2: WARNING: skipping paragraph macro: IP empty

mandoc: fuse.4:34:2: WARNING: skipping paragraph macro: PP after SH
mandoc: lirc.4:68:2: WARNING: skipping paragraph macro: PP after SS

mandoc: msr.4:59:2: WARNING: skipping paragraph macro: PP empty

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 man4/fuse.4 |  5 -----
 man4/lirc.4 | 10 ----------
 man4/msr.4  |  1 -
 man4/st.4   |  3 ---
 man4/veth.4 |  1 -
 5 files changed, 20 deletions(-)

diff --git a/man4/fuse.4 b/man4/fuse.4
index 4c40c801a..c1416fb64 100644
--- a/man4/fuse.4
+++ b/man4/fuse.4
@@ -31,7 +31,6 @@ fuse \- Filesystem in Userspace (FUSE) device
 .B #include <linux/fuse.h>
 .fi
 .SH DESCRIPTION
-.PP
 This device is the primary interface between the FUSE filesystem driver
 and a user-space process wishing to provide the filesystem (referred to
 in the rest of this manual page as the
@@ -241,7 +240,6 @@ struct fuse_attr_out {
 };
 .EE
 .in
-.IP
 .TP
 .B FUSE_ACCESS
 .IP
@@ -285,7 +283,6 @@ filesystem should validate that the requested
 are valid for the indicated resource and then send a reply with the
 following format:
 .IP
-.IP
 .in +4n
 .EX
 struct fuse_open_out {
@@ -296,7 +293,6 @@ struct fuse_open_out {
 .EE
 .in
 .IP
-.IP
 The
 .I fh
 field is an opaque identifier that the kernel will use to refer
@@ -333,7 +329,6 @@ struct fuse_read_in {
 .EE
 .in
 .IP
-.IP
 The requested action is to read up to
 .I size
 bytes of the file or directory, starting at
diff --git a/man4/lirc.4 b/man4/lirc.4
index 29bbeea34..475fed848 100644
--- a/man4/lirc.4
+++ b/man4/lirc.4
@@ -25,7 +25,6 @@
 .SH NAME
 lirc \- lirc devices
 .SH DESCRIPTION
-.PP
 The
 .I /dev/lirc*
 character devices provide a low-level
@@ -65,7 +64,6 @@ receiving and sending is supported, and in which modes, amongst other
 features.
 .\"
 .SS Reading input with the LIRC_MODE_MODE2 mode
-.PP
 In the \fBLIRC_MODE_MODE2 mode\fR, the data returned by
 .BR read (2)
 provides 32-bit values representing a space or a pulse duration.
@@ -90,7 +88,6 @@ The package reflects a timeout; see the
 ioctl.
 .\"
 .SS Reading input with the LIRC_MODE_SCANCODE mode
-.PP
 In the \fBLIRC_MODE_SCANCODE\fR
 mode, the data returned by
 .BR read (2)
@@ -100,7 +97,6 @@ is stored in \fIrc_proto\fR.
 This field has one the values of the \fIenum rc_proto\fR.
 .\"
 .SS Writing output with the LIRC_MODE_PULSE mode
-.PP
 The data written to the character device using
 .BR write (2)
 is a pulse/space sequence of integer values.
@@ -116,7 +112,6 @@ If more data is provided than the hardware can send, the
 call fails with the error
 .BR EINVAL .
 .SS Writing output with the LIRC_MODE_SCANCODE mode
-.PP
 The data written to the character devices must be a single struct
 \fIlirc_scancode\fR.
 The \fIscancode\fR and \fIrc_proto\fR fields must
@@ -127,7 +122,6 @@ The protocol or scancode is invalid, or the
 .B lirc
 device cannot transmit.
 .SH IOCTL COMMANDS
-.PP
 The LIRC device's ioctl definition is bound by the ioctl function
 definition of
 .IR "struct file_operations" ,
@@ -153,7 +147,6 @@ referred to below as
 .IR val .
 .\"
 .SS Always Supported Commands
-.PP
 \fI/dev/lirc*\fR devices always support the following commands:
 .TP 4
 .BR LIRC_GET_FEATURES " (\fIvoid\fP)"
@@ -166,7 +159,6 @@ it is safe to assume it is not a
 device.
 .\"
 .SS Optional Commands
-.PP
 Some
 .B lirc
 devices support the commands listed below.
@@ -241,7 +233,6 @@ is a number in the range [0,100] which
 describes the pulse width as a percentage of the total cycle.
 Currently, no special meaning is defined for 0 or 100, but the values
 are reserved for future use.
-.IP
 .TP
 .BR LIRC_GET_MIN_TIMEOUT " (\fIvoid\fP)", " "\
 LIRC_GET_MAX_TIMEOUT " (\fIvoid\fP)"
@@ -363,7 +354,6 @@ Trying to disable a wide band receiver while carrier reports are active
 will do nothing.
 .\"
 .SH FEATURES
-.PP
 the
 .B LIRC_GET_FEATURES
 ioctl returns a bit mask describing features of the driver.
diff --git a/man4/msr.4 b/man4/msr.4
index 9feb78a4b..38e4e8e18 100644
--- a/man4/msr.4
+++ b/man4/msr.4
@@ -56,7 +56,6 @@ to load it explicitly before use:
 $ modprobe msr
 .EE
 .in
-.PP
 .SH SEE ALSO
 Intel Corporation Intel 64 and IA-32 Architectures
 Software Developer's Manual Volume 3B Appendix B,
diff --git a/man4/st.4 b/man4/st.4
index 770ed40e5..151e8b35b 100644
--- a/man4/st.4
+++ b/man4/st.4
@@ -238,7 +238,6 @@ driver.
 The definitions below are from
 .IR /usr/include/linux/mtio.h :
 .SS MTIOCTOP \(em perform a tape operation
-.PP
 This request takes an argument of type
 .IR "(struct mtop\ *)" .
 Not all drives support all operations.
@@ -686,7 +685,6 @@ the cleaning request.
 If the pattern is nonzero, the pattern must match
 the masked sense data byte.
 .SS MTIOCGET \(em get status
-.PP
 This request takes an argument of type
 .IR "(struct mtget\ *)" .
 .PP
@@ -815,7 +813,6 @@ This value is set to \-1 when the block number is unknown (e.g., after
 or
 .BR MTSEEK ).
 .SS MTIOCPOS \(em get tape position
-.PP
 This request takes an argument of type
 .I "(struct mtpos\ *)"
 and reports the drive's notion of the current tape block number,
diff --git a/man4/veth.4 b/man4/veth.4
index 1cc473434..e5d11b2b6 100644
--- a/man4/veth.4
+++ b/man4/veth.4
@@ -98,7 +98,6 @@ NIC statistics:
 16: ve_B@ve_A: <BROADCAST,MULTICAST,M-DOWN> mtu 1500 qdisc ...
 .EE
 .in
-.PP
 .SH "SEE ALSO"
 .BR clone (2),
 .BR network_namespaces (7),
-- 
2.27.0

^ permalink raw reply related	[flat|nested] 2+ messages in thread