Module Name: src
Committed By: wiz
Date: Sun Apr 15 18:09:50 UTC 2012
Modified Files:
src/bin/ps: ps.1
Log Message:
- choose better argument name for `-U';
- add argument names for options in man page;
- improve wording, punctuation, capitalization.
>From Bug Hunting in email.
To generate a diff of this commit:
cvs rdiff -u -r1.98 -r1.99 src/bin/ps/ps.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/bin/ps/ps.1
diff -u src/bin/ps/ps.1:1.98 src/bin/ps/ps.1:1.99
--- src/bin/ps/ps.1:1.98 Thu Mar 15 15:49:59 2012
+++ src/bin/ps/ps.1 Sun Apr 15 18:09:50 2012
@@ -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 @@ Print information associated with the fo
.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 @@ Display information associated with the
.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 @@ followed by a customised header string m
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 @@ options.
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 @@ and
.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 @@ terminal device and a minus sign
.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 @@ The
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 @@ The process is being traced or debugged.
.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 @@ real group
.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 @@ default swap device
.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 ,
