docs: mention long options in man pmap.1

Also add range option to manual page. The commit includes few generic manual
clean ups as well.

Signed-off-by: Sami Kerola <kerolasa@iki.fi>

diff --git a/pmap.1 b/pmap.1
index 9327c6bc4e3b503aa46e991900e7781c456a515c..c96b6109f46290280a234f1ad0c78d3bee2d853e 100644 (file)
--- a/pmap.1
+++ b/pmap.1
@@ -5,37 +5,44 @@
 .\" Licensed under version 2 of the GNU General Public License.
 .\" Written by Albert Cahalan.
 .\"
-.TH PMAP 1 "October 26, 2002" "Linux" "Linux User's Manual"
+.TH PMAP "1" "June 2011" "procps-ng" "User Commands"
 .SH NAME
 pmap \- report memory map of a process
-
 .SH SYNOPSIS
 .B pmap
-.RB [ \-x | \-d ]
-.RB [ \-q ]
-.I pid
-\& ...
-.br
-.B pmap \-V
-
+[\fIoptions\fR] \fIpid\fR [...]
 .SH DESCRIPTION
 The pmap command reports the memory map of a process or processes.
-
-.SH "GENERAL OPTIONS"
-.TS
-lB l l.
-\-x    extended        Show the extended format.
-\-d    device  Show the device format.
-\-q    quiet   Do not display some header/footer lines.
-\-V    show version    Displays version of program.
-.TE
-
+.SH OPTIONS
+.TP
+\fB\-x\fR, \fB\-\-extended\fR
+Show the extended format.
+.TP
+\fB\-d\fR, \fB\-\-device\fR
+Show the device format.
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Do not display some header or footer lines.
+.TP
+\fB\-A\fR, \fB\-\-range\fR \fIlow\fR,\fIhigh\fR
+Limit results to the given range to
+.I low
+and
+.I high
+address range.  Notice that the low and high arguments are single string
+separated with comma.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display help text and exit.
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Display version information and exit.
 .SH "SEE ALSO"
 .BR ps (1),
 .BR pgrep (1)
-
 .SH STANDARDS
 No standards apply, but pmap looks an awful lot like a SunOS command.
-
-.SH BUG REPORTS
-Please send bug reports to <procps@freelists.org>
+.SH "REPORTING BUGS"
+Please send bug reports to
+.UR procps\@freelists.org
+.UE