[src/trunk]: src/bin/ps - choose better argument name for `-U';

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/3e045e51c7ee
branches:  trunk
changeset: 778837:3e045e51c7ee
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Apr 15 18:09:50 2012 +0000

description:
- choose better argument name for `-U';
- add argument names for options in man page;
- improve wording, punctuation, capitalization.

>From Bug Hunting in email.

diffstat:

 bin/ps/ps.1 |  45 +++++++++++++++++++++------------------------
 1 files changed, 21 insertions(+), 24 deletions(-)

diffs (137 lines):

diff -r 3a6eb6d7d7a8 -r 3e045e51c7ee bin/ps/ps.1
--- a/bin/ps/ps.1       Sun Apr 15 16:34:11 2012 +0000
+++ b/bin/ps/ps.1       Sun Apr 15 18:09:50 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ps.1,v 1.98 2012/03/15 15:49:59 wiz Exp $
+.\"    $NetBSD: ps.1,v 1.99 2012/04/15 18:09:50 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1991, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -45,7 +45,7 @@
 .Op Fl o Ar fmt
 .Op Fl p Ar pid
 .Op Fl t Ar tty
-.Op Fl U Ar username
+.Op Fl U Ar user
 .Op Fl W Ar swap
 .Nm
 .Fl L
@@ -111,7 +111,7 @@
 .Ar user , pid , ppid , pgid , sess , jobc , state , tt , time ,
 and
 .Ar command .
-.It Fl k
+.It Fl k Ar key
 Sort the output using the space or comma separated list of keywords.
 Multiple sort keys may be specified, using any of the
 .Fl k , Fl m ,
@@ -128,19 +128,19 @@
 .Ar tt , time ,
 and
 .Ar command .
-.It Fl M
+.It Fl M Ar core
 Extract values from the specified core file instead of the running system.
 .It Fl m
-Sort by memory usage,
-equivalent to
+Sort by memory usage.
+This is equivalent to
 .Fl k Ar vsz .
-.It Fl N
-Extract the name list from the specified system instead of the default
+.It Fl N Ar system
+Extract the name list from the specified system instead of the default,
 .Dq Pa /netbsd .
 Ignored unless
 .Fl M
 is specified.
-.It Fl O
+.It Fl O Ar fmt
 Display information associated with the space or comma separated list
 of keywords specified.
 The
@@ -164,7 +164,7 @@
 as described in more detail under the
 .Fl o
 option.
-.It Fl o
+.It Fl o Ar fmt
 Display information associated with the space or comma separated list
 of keywords specified.
 Use of the
@@ -194,7 +194,7 @@
 If all the keywords to be displayed have customised headers,
 and all the customised headers are entirely empty,
 then the header line is not printed at all.
-.It Fl p
+.It Fl p Ar pid
 Display information associated with the specified process
 .Tn ID .
 .It Fl r
@@ -214,7 +214,7 @@
 .It Fl T
 Display information about processes attached to the device associated
 with the standard input.
-.It Fl t
+.It Fl t Ar tty
 Display information about processes attached to the specified terminal
 device.
 Use a question mark
@@ -224,11 +224,9 @@
 .Pq Dq -
 for processes that have
 been revoked from their terminal device.
-.It Fl U
-Displays processes belonging to the user whose username or uid has
-been given to the
-.Fl U
-switch.
+.It Fl U Ar user
+Display processes belonging to the specified user,
+given either as a user name or a uid.
 .It Fl u
 Display information associated with the following keywords:
 .Ar user , pid , %cpu , %mem , vsz , rss , tt , state , start , time ,
@@ -250,9 +248,8 @@
 option implies the
 .Fl m
 option.
-.It Fl W
-Extract swap information from the specified file instead of the
-default
+.It Fl W Ar swap
+Extract swap information from the specified file instead of the default,
 .Dq Pa /dev/drum .
 Ignored unless
 .Fl M
@@ -400,7 +397,7 @@
 .It Ar tt
 An abbreviation for the pathname of the controlling terminal, if any.
 The abbreviation consists of the two letters following
-.Dq Pa /dev/tty ,
+.Dq Pa /dev/tty
 or, for the console,
 .Dq co .
 This is followed by a
@@ -594,7 +591,7 @@
 .It Ar rlink
 reverse link on run queue, or 0
 .It Ar rlwp
-Number of LWPs on a processor or run queue
+number of LWPs on a processor or run queue
 .It Ar rss
 resident set size
 .It Ar rsz
@@ -688,9 +685,9 @@
 .It Pa /var/run/dev.db
 /dev name database
 .It Pa /var/db/kvm.db
-system namelist database
+system name list database
 .It Pa /netbsd
-default system namelist
+default system name list
 .El
 .Sh SEE ALSO
 .Xr kill 1 ,