From dd57e856d8c2ce90b9ab60aa59d69d8cbbb20a7c Mon Sep 17 00:00:00 2001 From: Jim Warner Date: Thu, 10 Mar 2022 00:00:00 -0600 Subject: [PATCH] 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 --- NEWS | 1 + top/top.1 | 15 ++++++++++++++- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index 15251a36..657c442f 100644 --- 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 314ab972..1aa04a83 100644 --- 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