From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: util-linux@vger.kernel.org
Subject: [PATCH] doc: text-utils/*: fix some warnings from "mandoc -T lint"
Date: Thu, 11 Jun 2020 02:18:20 +0000 [thread overview]
Message-ID: <20200611021820.GA30948@rhi.hi.is> (raw)
mandoc: ./text-utils/column.1:58:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./text-utils/column.1:63:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./text-utils/column.1:119:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./text-utils/column.1:171:1: WARNING: skipping paragraph macro: sp after PP
mandoc: ./text-utils/column.1:170:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./text-utils/hexdump.1:206:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./text-utils/hexdump.1:356:2: STYLE: fill mode already disabled, skipping: nf
mandoc: ./text-utils/hexdump.1:359:2: STYLE: fill mode already disabled, skipping: nf
mandoc: ./text-utils/hexdump.1:362:2: STYLE: fill mode already disabled, skipping: nf
mandoc: ./text-utils/hexdump.1:366:2: STYLE: fill mode already disabled, skipping: nf
mandoc: ./text-utils/hexdump.1:369:2: STYLE: fill mode already disabled, skipping: nf
####
There are no changes in the output from "nroff" and "groff", except
for a reformat of a paragraph caused by "fill-mode".
Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
text-utils/column.1 | 5 -----
text-utils/hexdump.1 | 7 +++----
2 files changed, 3 insertions(+), 9 deletions(-)
diff --git a/text-utils/column.1 b/text-utils/column.1
index 634c1be84..4c2de1cc5 100644
--- a/text-utils/column.1
+++ b/text-utils/column.1
@@ -55,12 +55,10 @@ possible to modify by \fB\-\-table-*\fP options. Use this mode if not sure.
.PP
Input is taken from \fIfile\fR, or otherwise from standard input. Empty lines
are ignored and all invalid multibyte sequences are encoded by \\x<hex> convention.
-.PP
.SH OPTIONS
The argument \fIcolumns\fP for \fB\-\-table-*\fP options is comma separated
list of the column names as defined by \fB\-\-table-columns\fP or it's column
number in order as specified by input. It's possible to mix names and numbers.
-.PP
.IP "\fB\-J, \-\-json\fP"
Use JSON output format to print the table, the option
\fB\-\-table\-columns\fP is required and the option \fB\-\-table\-name\fP is recommended.
@@ -116,7 +114,6 @@ other anomalies in child and parent relation are silently ignored.
Specify column with line ID to create child-parent relation.
.IP "\fB\-p, \-\-tree\-parent\fP \fIcolumn\fP"
Specify column with parent ID to create child-parent relation.
-.PP
.IP "\fB\-x, \-\-fillrows\fP"
Fill rows before filling columns.
.IP "\fB\-V\fR, \fB\-\-version\fR"
@@ -167,8 +164,6 @@ Print fstab and hide unnamed columns:
.EX
\fBsed 's/#.*//' /etc/fstab | column \-\-table \-\-table-columns SOURCE,TARGET,TYPE \-\-table-hide \-\fR
.EE
-.PP
-
.PP
Print a tree:
.EX
diff --git a/text-utils/hexdump.1 b/text-utils/hexdump.1
index abf1b8370..eb7713ce6 100644
--- a/text-utils/hexdump.1
+++ b/text-utils/hexdump.1
@@ -203,7 +203,6 @@ NULL
\ev
.PD
.RE
-.PP
.SS Conversion strings
The
.B hexdump
@@ -353,20 +352,20 @@ Display the input in perusal format:
"%06.6_ao " 12/1 "%3_u "
"\et\et" "%_p "
"\en"
-.nf
+.fi
.PP
Implement the \-x option:
.nf
"%07.7_Ax\en"
"%07.7_ax " 8/2 "%04x " "\en"
-.nf
+.fi
.PP
MBR Boot Signature example: Highlight the addresses cyan and the bytes at
offsets 510 and 511 green if their value is 0xAA55, red otherwise.
.nf
"%07.7_Ax_L[cyan]\en"
"%07.7_ax_L[cyan] " 8/2 " %04x_L[green:0xAA55@510-511,!red:0xAA55@510-511] " "\en"
-.nf
+.fi
.SH COLORS
Implicit coloring can be disabled by an empty file \fI/etc/terminal-colors.d/hexdump.disable\fR.
--
2.26.2
reply other threads:[~2020-06-11 2:18 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
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=20200611021820.GA30948@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).