From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: mtk.manpages@gmail.com
Cc: linux-man@vger.kernel.org
Subject: [PATCH] man4/*: srcfix, fix warnings from "mandoc -Tlint"
Date: Sat, 20 Jun 2020 23:36:47 +0000 [thread overview]
Message-ID: <20200620233647.GA8900@rhi.hi.is> (raw)
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
next reply other threads:[~2020-06-20 23:36 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-06-20 23:36 Bjarni Ingi Gislason [this message]
2020-06-21 7:25 ` [PATCH] man4/*: 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=20200620233647.GA8900@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