docs: improve wording, formatting and accuracy of ipcs man page

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

sys-utils/ipcs.1

@@ -1,61 +1,45 @@
 .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
 .\" May be distributed under the GNU General Public License
-.TH IPCS "1" "September 2011" "util-linux" "User Commands"
+.TH IPCS "1" "January 2013" "util-linux" "User Commands"
 .SH NAME
-ipcs \- provide information on ipc facilities
+ipcs \- provide information on IPC facilities
 .SH SYNOPSIS
 .B ipcs
-[resource] [...] [output\-format]
+.RB [ resource\-option "] [" output\-format ]
 .br
 .B ipcs
-[resource]
+.RB [ resource\-option ]
-.I \-i id
+.BI \-i " id"
 .SH DESCRIPTION
 .B ipcs
-provides information on the ipc facilities for which the calling process
+provides information on the inter-process communication facilities
-has read access.
+for which the calling process has read access.
 .SH OPTIONS
 .TP
 \fB\-i\fR, \fB\-\-id\fR \fIid\fR
-Print details only on resource identified by
+Print details only on the resource identified by
 .IR id .
 .TP
 \fB\-h\fR, \fB\-\-help\fR
-Display this help and exit.
+Display a help text and exit.
 .TP
 \fB\-V\fR, \fB\-\-version\fR
-Output version information and exit.
+Display version information and exit.
-.SH "RESOURCE OPTIONS"
+.SS "Resource options"
-.TP
-\fB\-m\fR, \fB\-\-shmems\fR
-Write information about active shared memory segments.
 .TP
 \fB\-q\fR, \fB\-\-queues\fR
 Write information about active message queues.
 .TP
+\fB\-m\fR, \fB\-\-shmems\fR
+Write information about active shared memory segments.
+.TP
 \fB\-s\fR, \fB\-\-semaphores\fR
 Write information about active semaphore sets.
 .TP
 \fB\-a\fR, \fB\-\-all\fR
-Write information about all resources (default).
+Write information about all three resources (default).
-.SH "OUTPUT FORMATS"
+.SS "Output formats"
-.TP
+Of these options only one takes effect: the last one specified.
-\fB\-t\fR, \fB\-\-time\fR
-Write time information. Time of the last control operation that changed the
-access permissions for all facilities, time of the last
-.I msgsnd()
-and
-.I msgrcv()
-operations on message queues, time of the last
-.I shmat()
-and
-.I shmdt()
-operations on shared memory, and time of the last
-.I semop()
-operation on semaphores.
-.TP
-\fB\-p\fR, \fB\-\-pid\fR
-Show creator and last operations PIDs.
 .TP
 \fB\-c\fR, \fB\-\-creator\fR
 Show creator and owner.
@@ -63,14 +47,33 @@ Show creator and owner.
 \fB\-l\fR, \fB\-\-limits\fR
 Show resource limits.
 .TP
+\fB\-p\fR, \fB\-\-pid\fR
+Show PIDs of creator and last operator.
+.TP
+\fB\-t\fR, \fB\-\-time\fR
+Write time information.  The time of the last control operation that changed
+the access permissions for all facilities, the time of the last
+.I msgsnd()
+and
+.I msgrcv()
+operations on message queues, the time of the last
+.I shmat()
+and
+.I shmdt()
+operations on shared memory, and the time of the last
+.I semop()
+operation on semaphores.
+.TP
 \fB\-u\fR, \fB\-\-summary\fR
 Show status summary.
-.TP
+.SS "Representation"
-.B \-\-human
+These affect only the \fB\-l\fR (\fB\-\-limits\fR) option.
-Print sizes in human readable format.
 .TP
 \fB\-b\fR, \fB\-\-bytes\fR
 Print sizes in bytes.
+.TP
+.B \-\-human
+Print sizes in human-readable format.
 .SH SEE ALSO
 .BR ipcrm (1),
 .BR ipcmk (1),
@@ -83,7 +86,8 @@ Print sizes in bytes.
 .BR shmget (2)
 .SH CONFORMING TO
 The Linux ipcs utility is not fully compatible to the POSIX ipcs utility.
-The Linux version does not support the
+The Linux version does not support the POSIX
+.BR \-a ,
 .B \-b
 and
 .B \-o
@@ -91,7 +95,8 @@ options, but does support the
 .B \-l
 and
 .B \-u
-options not defined by POSIX. The portable application shall not use the
+options not defined by POSIX.  A portable application shall not use the
+.BR \-a ,
 .BR \-b ,
 .BR \-o ,
 .BR \-l ,