doc: added provision for autogroup nice (AGNI) changes

Signed-off-by: Jim Warner <james.warner@comcast.net>

diff --git a/NEWS b/NEWS
index 0e705e92629a6bca8ac5bf3158c01e43f06066b4..2209e61548d8bcfdd960460741d211a494ccfc0a 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -6,6 +6,7 @@ procps-ng-NEXT
   * sysctl: print dotted keys again
   * top: fix 'smaps' bug preventing build under clang      issue #235
   * top: column highlighting allowed under 'L' or 'O'
+  * top: can alter autogroup nice value (like 'r' renice)
 
 procps-ng-4.0.0
 ---------------

diff --git a/top/top.1 b/top/top.1
index 814bccd5fffb46a6967a71fb1b037c184aa62134..cc12a5fc1e5f574f13a5c5375d4c6ce1c25c4d24 100644 (file)
--- a/top/top.1
+++ b/top/top.1
@@ -1262,7 +1262,7 @@ depending on the context in which they are issued.
 .nf
   4a.\fI Global-Commands \fR
         <Ent/Sp> ?, =, 0,
-        A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z
+        A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z, ^R
   4b.\fI Summary-Area-Commands \fR
         C, l, t, m, 1, 2, 3, 4, !
   4c.\fI Task-Area-Commands \fR
@@ -1520,6 +1520,22 @@ This key will take you to a separate screen where you can change the
 colors for the \*(CW, or for all windows.
 For details regarding this \*(CI \*(Xt 4d. COLOR Mapping.
 
+.TP 7
+*\ \ \fB^R\fR\ \ :\fIRenice-an-Autogroup \fR (Ctrl key + `r')
+You will be prompted for a PID and then the value for its
+autogroup AGNI.
+
+Entering no PID will be interpreted as the default shown in
+the prompt (the first task displayed).
+
+A positive AGNI value will cause processes in that autogroup
+to lose priority.
+Conversely, a negative value causes them to be viewed more
+favorably by the kernel.
+Ordinary users are not allowed to set negative AGNI values.
+
+If you wish to abort the renice process type <Esc>.
+
 .IP "*" 3
 The commands shown with an \*(AK are not available in Secure mode,
 nor will they be shown on the level-1 help screen.