Util-Linux Archive on lore.kernel.org
 help / color / Atom feed
* [PATCH] doc: text-utils/*: fix some warnings from "mandoc -T lint"
@ 2020-06-11  2:18 Bjarni Ingi Gislason
  0 siblings, 0 replies; only message in thread
From: Bjarni Ingi Gislason @ 2020-06-11  2:18 UTC (permalink / raw)
  To: util-linux

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

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, back to index

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-06-11  2:18 [PATCH] doc: text-utils/*: fix some warnings from "mandoc -T lint" Bjarni Ingi Gislason

Util-Linux Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/util-linux/0 util-linux/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 util-linux util-linux/ https://lore.kernel.org/util-linux \
		util-linux@vger.kernel.org
	public-inbox-index util-linux

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.util-linux


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git