doc: document 'scale_tics' catch-up for Ctrl-E scaling

[ the original newlib commit message(s) appear below ]

------------------------------------- newlib patch ---
doc: document 'scale_tics' function for Ctrl-E scaling

[ i also tweaked that 'STARTED' narrative just a bit ]
[ since its original wording implied the value could ]
[ change, whereas it's fixed when a task is started. ]

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

diff --git a/NEWS b/NEWS
index 15251a3625eb6a6204532877276f4b02358fde89..657c442fdaa2047e7da2bcbc82bb608bd15168da 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -5,6 +5,7 @@ procps-ng-NEXT
   * top: 'F' key is now a new forest view 'focus' toggle
   * top: summary area memory lines can print two abreast
   * top: added long versions of command line options
+  * top: the time related fields can now be user scaled
 
 procps-ng-3.3.17
 ---------------

diff --git a/top/top.1 b/top/top.1
index 314ab972622100da0b4badc13ed62550e61c3ac2..1aa04a83b6df44d22dc0e4c9a5c33dd64804cad9 100644 (file)
--- a/top/top.1
+++ b/top/top.1
@@ -1134,7 +1134,7 @@ depending on the context in which they are issued.
         C, l, t, m, 1, 2, 3, 4, !
   4c.\fI Task-Area-Commands \fR
         Appearance:  b, J, j, x, y, z
-        Content:     c, F, f, O, o, S, U, u, V, v
+        Content:     c, F, f, O, o, S, U, u, V, v, ^E
         Size:        #, i, n
         Sorting:     <, >, f, R
   4d.\fI Color-Mapping \fR
@@ -1673,6 +1673,19 @@ vertical scrolling.
 If the target process has not forked any children, this key has no effect.
 It also has no effect when not in forest view mode.
 
+.TP 7
+\ \ \fB^E\fR\ \ :\fIScale-CPU-Time-fields\fR (Ctrl key + `e')
+The `time' fields are normally displayed with the greatest
+precision their widths permit.
+This toggle reduces that precision until it wraps.
+It also illustrates the scaling those fields \fImight\fR experience
+automatically, which usually depends on how long the system runs.
+
+For example, if 'MMM:SS.hh' is shown, each ^E keystroke would change
+it to: 'MM:SS', 'Hours,MM', 'Days+Hours' and finally 'Weeks+Days'.
+
+Not all time fields are subject to the full range of such scaling.
+
 .\" ..................................................
 .PP
 .B SIZE\fR of \*(TW