document u U -u -U

diff --git a/NEWS b/NEWS
index 81b2c061c6d6340bff055a6f631ca2744979e3ec..75a0455e1b8e63402b9e59dbcbaec502aba39c42 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,9 @@
+procps-3.1.2 --> procps-3.1.3
+
+top: user selection
+sysctl: -e
+w: stdout, not stderr -- thanks to Sander van Malssen
+
 procps-3.1.1 --> procps-3.1.2
 
 better RPM generation

diff --git a/top.1 b/top.1
index bb5fc3661f2d943bdb06e786850e0f86bf795bbc..4520090e4c60e88425e8de406ee18d664c309cb7 100644 (file)
--- a/top.1
+++ b/top.1
@@ -258,6 +258,16 @@ When this toggle is \*F, tasks that are idled or zombied will not be displayed.
 Specifies the maximum number of iterations, or frames, \*(Me should
 produce before ending.
 
+.TP 5
+\-\fBu\fR :\fB Monitor by user\fR as:\fB\ \ -u somebody
+Monitor only processes with an effective UID or user name
+matching that given.
+
+.TP 5
+\-\fBU\fR :\fB Monitor by user\fR as:\fB\ \ -U somebody
+Monitor only processes with a UID or user name matching that given.
+This matches real, effective, saved, and filesystem UIDs.
+
 .TP 5
 \-\fBp\fR :\fB Monitor PIDs\fR as:\fB\ \ -pN1 -pN2 ...\fR\ \ or\fB\ \ -pN1, N2 [,...]
 Monitor only processes with specified process IDs.
@@ -627,6 +637,18 @@ When operating in 'Solaris mode' ('I' toggled \*F), a task's \*(Pu usage
 will be divided by the total number of \*(PUs.
 After issuing this command, you'll be informed of the new state of this toggle.
 
+.TP 7
+\ \ \'\fBu\fR\' :\fIselect a user\fR
+You will be prompted for a UID or username. Only processes
+belonging to the selected user will be displayed. This option
+matches on the effective UID.
+
+.TP 7
+\ \ \'\fBU\fR\' :\fIselect a user\fR
+You will be prompted for a UID or username. Only processes
+belonging to the selected user will be displayed. This option
+matches on the real, effective, saved, and filesystem UID.
+
 .TP 7
 *\ \'\fBk\fR\' :\fIKill_a_task\fR
 You will be prompted for a PID and then the signal to send.