From 5c4c23925715b13412588fe8b39efcb1eb5ade4e Mon Sep 17 00:00:00 2001 From: Jim Warner Date: Thu, 3 Mar 2022 00:00:00 -0600 Subject: [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 | 3 ++- top/top.1 | 24 +++++++++++++++++++----- 2 files changed, 21 insertions(+), 6 deletions(-) diff --git a/NEWS b/NEWS index b0ecfc0d..c89fd2ed 100644 --- a/NEWS +++ b/NEWS @@ -32,7 +32,8 @@ procps-ng-NEXT * top: summary area memory lines can print two abreast * top: added two new autogroup fields * top: added long versions of command line options - * top: added 'start time' and 'cpu utilization' fields + * top: added cpu utilization & 2 time related fields + * top: the time related fields can now be user scaled * uptime: print short/pretty format correctly issue #217 * vmstat: add -y option to remove first line merge !72 diff --git a/top/top.1 b/top/top.1 index ae33aa2e..96cd6d59 100644 --- a/top/top.1 +++ b/top/top.1 @@ -753,6 +753,8 @@ Thus, the most recently started task will display the smallest time interval. The value will be expressed as 'HH,MM' (hours,minutes) but is subject to additional scaling if the interval becomes too great to fit column width. +At that point it will be scaled to 'DD+HH' (days+hours) and possibly +beyond. .TP 4 \fBENVIRON \*(Em Environment variables \fR @@ -992,10 +994,9 @@ login shell. The length of time since system boot when a process started. Thus, the most recently started task will display the largest time interval. -The value will be expressed as 'MM:SS' (minutes:sceonds) until the -interval becomes too great to fit column width. -At that point it will be scaled to 'HH,MM' (hours,minutes) and possibly -beyond. +The value will be expressed as 'MM:SS' (minutes:seconds). +But if the interval is too great to fit column width it will be scaled +as 'HH,MM' (hours,minutes) and possibly beyond. .TP 4 \fBSUID \*(Em Saved User Id \fR @@ -1261,7 +1262,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 @@ -1800,6 +1801,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