[src/trunk]: src/bin/ps Fix obsolete example (that referred to letters in pro...

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

details:   https://anonhg.NetBSD.org/src/rev/79a0a24d79b3
branches:  trunk
changeset: 778080:79a0a24d79b3
user:      christos <christos%NetBSD.org@localhost>
date:      Thu Mar 15 15:43:43 2012 +0000

description:
Fix obsolete example (that referred to letters in process state that are
not set anymore), and clarify their meaning.

diffstat:

 bin/ps/ps.1 |  26 +++++++++++++++-----------
 1 files changed, 15 insertions(+), 11 deletions(-)

diffs (76 lines):

diff -r cd1908b16783 -r 79a0a24d79b3 bin/ps/ps.1
--- a/bin/ps/ps.1       Thu Mar 15 15:04:23 2012 +0000
+++ b/bin/ps/ps.1       Thu Mar 15 15:43:43 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ps.1,v 1.96 2012/02/23 21:54:28 dholland Exp $
+.\"    $NetBSD: ps.1,v 1.97 2012/03/15 15:43:43 christos Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1991, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)ps.1       8.3 (Berkeley) 4/18/94
 .\"
-.Dd February 23, 2012
+.Dd March 15, 2012
 .Dt PS 1
 .Os
 .Sh NAME
@@ -337,26 +337,30 @@
 format.
 .It Ar state
 The state is given by a sequence of letters, for example,
-.Dq Tn RWNA .
+.Dq Tn RNs .
 The first letter indicates the run state of the process:
 .Pp
 .Bl -tag -width indent -compact
 .It D
-Marks a process in disk (or other short term, uninterruptible) wait.
+Marks a process in device or other short term, uninterruptible wait.
 .It I
-Marks a process that is idle (sleeping for longer than about 20 seconds).
+Marks a process that is idle (sleeping interruptibly for longer than about
+.Dv MAXSLP
+(default 20) seconds).
 .It O
 Marks a process running on a processor.
 .It R
 Marks a runnable process, or one that is in the process of creation.
 .It S
-Marks a process that is sleeping for less than about 20 seconds.
+Marks a process that is sleeping interruptibly for less than about 
+.Dv MAXSLP
+(default 20) seconds.
 .It T
 Marks a stopped process.
 .It U
 Marks a suspended process.
 .It Z
-Marks a dead process (a
+Marks a dead process that has exited, but not been waited for (a
 .Dq zombie ) .
 .El
 .Pp
@@ -373,17 +377,17 @@
 .Tn CPU
 scheduling priority.
 .It a
-The process is using scheduler activations.
+The process is using scheduler activations (deprecated).
 .It E
-The process is trying to exit.
+The process is in the process of exiting.
 .It K
 The process is a kernel thread or system process.
 .It l
 The process has multiple LWPs.
 .It N
-The process has reduced
+The process is niced (has reduced
 .Tn CPU
-scheduling priority (see
+scheduling priority) (see
 .Xr setpriority 2 ) .
 .It s
 The process is a session leader.