docs: adjust some formatting and wordings in a handful of man pages

Signed-off-by: Benno Schulenberg <bensberg@justemail.net>

1 files changed, 69 insertions, 60 deletions

diff --git a/disk-utils/partx.8 b/disk-utils/partx.8
index 005fe6662..fb0fe381b 100644
--- a/disk-utils/partx.8
+++ b/disk-utils/partx.8
@@ -3,7 +3,8 @@
 .\" Copyright 2007 Red Hat, Inc.
 .\" Copyright 2010 Davidlohr Bueso <dave@gnu.org>
 .\" May be distributed under the GNU General Public License
-.TH PARTX "8" "June 2012" "util-linux" "System Administration"
+.\"
+.TH PARTX "8" "December 2014" "util-linux" "System Administration"
 .SH NAME
 partx \- tell the Linux kernel about the presence and numbering of on-disk partitions
 .SH SYNOPSIS
@@ -43,24 +44,49 @@ The
 tells the kernel about the presence and numbering of on-disk
 partitions.
 .SH OPTIONS
-.IP "\fB\-a\fR, \fB\-\-add\fP"
+.TP
+.BR \-a , " \-\-add"
 Add the specified partitions, or read the disk and add all partitions.
-.IP "\fB\-b\fR, \fB\-\-bytes\fP"
+.TP
+.BR \-b , " \-\-bytes"
 Print the SIZE column in bytes rather than in human-readable format.
-.IP "\fB\-d\fR, \fB\-\-delete\fP"
+.TP
+.BR \-d , " \-\-delete"
 Delete the specified partitions or all partitions.
-.IP "\fB\-u\fR, \fB\-\-update\fP"
-Update the specified partitions.
-.IP "\fB\-g\fR, \fB\-\-noheadings\fP"
+.TP
+.BR \-g , " \-\-noheadings"
 Do not print a header line.
-.IP "\fB\-h\fR, \fB\-\-help\fP"
-Display help text and exit.
-.IP "\fB\-l\fR, \fB\-\-list\fP"
+.TP
+.BR \-l , " \-\-list"
 List the partitions.  Note that all numbers are in 512-byte sectors.
 This output format is DEPRECATED in favour of
 .BR \-\-show .
 Do not use it in newly written scripts.
-.IP "\fB\-o\fR, \fB\-\-output \fIlist\fP"
+.TP
+.BR \-n , " \-\-nr " \fIM : \fIN
+Specify the range of partitions.  For backward compatibility also the
+format \fIM\fB\-\fIN\fR is supported.
+The range may contain negative numbers, for example
+.B \-\-nr :\-1
+means the last partition, and
+.B \-\-nr \-2:\-1
+means the last two partitions.  Supported range specifications are:
+.RS 14
+.TP
+.I M
+Specifies just one partition (e.g.\& \fB\-\-nr 3\fR).
+.TP
+.IB M :
+Specifies the lower limit only (e.g.\& \fB\-\-nr 2:\fR).
+.TP
+.BI : N
+Specifies the upper limit only (e.g.\& \fB\-\-nr :4\fR).
+.TP
+.IB M : N
+Specifies the lower and upper limits (e.g.\& \fB\-\-nr 2:4\fR).
+.RE
+.TP
+.BR \-o , " \-\-output " \fIlist
 Define the output columns to use for
 .B \-\-show
 and
@@ -70,66 +96,49 @@ used.  Use
 .B \-\-help
 to get
 .I list
-of all supported columns.  This option cannot be combined with
+of all supported columns.  This option cannot be combined with the
 .BR \-\-add ,
 .BR \-\-delete ,
 or
 .B \-\-list
 options.
-.IP "\fB\-P\fR, \fB\-\-pairs\fP"
-Output using key="value" format.
-.IP "\fB\-n\fR, \fB\-\-nr \fIM:N\fP"
-Specify the range of partitions.  For backward compatibility also the
-format
-.I M\(enN
-is supported.  The range may contain negative numbers, for example
-.BI \-\-nr \ :\-1
-means the last partition, and
-.BI \-\-nr \ \-2:\-1
-means the last two partitions.  Supported range specifications are:
-.RS 14
 .TP
-.I M
-Specifies just one partition (e.g.\& \fB\-\-nr\fR
-.IR 3 ).
+.BR \-P , " \-\-pairs"
+Output using key="value" format.
 .TP
-.I M:
-Specifies lower limit only (e.g.\& \fB\-\-nr\fR
-.IR 2: ).
+.BR \-r , " \-\-raw"
+Use the raw output format.
 .TP
-.I :N
-Specifies upper limit only (e.g.\& \fB\-\-nr\fR
-.IR :4 ).
+.BR \-s , "\-\-show"
+List the partitions.  All numbers (except SIZE) are in 512-byte sectors.
+The output columns can be rearranged with the \fB\-\-output\fR option.
 .TP
-.IR M:N \ or
-.TQ
-.I M\(enN
-Specifies lower and upper limits (e.g.\& \fB\-\-nr\fR
-.IR 2:4 ).
-.RE
-.IP "\fB\-r\fR, \fB\-\-raw\fP"
-Use the raw output format.
-.IP "\fB\-s\fR, \fB\-\-show\fP"
-List the partitions.  All numbers (except SIZE) are in 512-byte
-sectors.  The output columns can be rearranged with the
-.B \-\-output
-option.
-.IP "\fB\-t\fR, \fB\-\-type \fItype\fP"
-Specify the partition table type
-.IR aix ,
-.IR bsd ,
-.IR dos ,
-.IR gpt ,
-.IR mac ,
-.IR minix ,
-.IR sgi ,
-.IR solaris_x86 ,
-.IR sun ,
-.IR ultrix ,
+.BR \-t , " \-\-type " \fItype
+Specify the partition table type, which can be one of
+.BR aix ,
+.BR bsd ,
+.BR dos ,
+.BR gpt ,
+.BR mac ,
+.BR minix ,
+.BR sgi ,
+.BR solaris_x86 ,
+.BR sun ,
+.BR ultrix ,
 or
-.IR unixware .
-.IP "\fB\-v\fR, \fB\-\-verbose\fP"
+.BR unixware .
+.TP
+.BR \-u , " \-\-update"
+Update the specified partitions.
+.TP
+.BR \-v , " \-\-verbose"
 Verbose mode.
+.TP
+.BR \-V , " \-\-version"
+Display version information and exit.
+.TP
+.BR \-h , " \-\-help"
+Display help text and exit.
 .SH EXAMPLES
 .TP
 partx \-\-show /dev/sdb3