doc: updated with new 'start time' & 'cpu utilization'

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

diff --git a/NEWS b/NEWS
index a487278ae1375cd4becae5ff29e9c2bf0b6a65a7..b0ecfc0dc00ad14fae2bfdbbb846e9e371388dd8 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -9,6 +9,7 @@ procps-ng-NEXT
   * library: add support for accessing smaps_rollup        issue #112, #201
   * library: add support for accessing autogroups
   * library: add support for LIBPROC_HIDE_KERNEL env var   merge #147
+  * library: add support for cpu utilization to pids i/f
   * pkill: Check for lt- variants of program name          issue #192
   * pgrep: Add newline after regex error message           merge #91
   * pgrep: Fix selection where uid/gid > 2^31              merge !146
@@ -31,6 +32,7 @@ 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
   * 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 0f32807d177d6be58687d50b631d2e946f2e4ede..61d62fd3b80b03e69f174f9a9a98b2af8a47a243 100644 (file)
--- a/top/top.1
+++ b/top/top.1
@@ -59,7 +59,7 @@ memory statistics and data for other users requires root privileges
 .
 .\" Document /////////////////////////////////////////////////////////////
 .\" ----------------------------------------------------------------------
-.TH TOP 1 "January 2022" "procps-ng" "User Commands"
+.TH TOP 1 "March 2022" "procps-ng" "User Commands"
 .\" ----------------------------------------------------------------------
 .nh
 
@@ -636,6 +636,16 @@ those unseen children.
 \*(XT 4c. TASK AREA Commands, CONTENT for more information regarding
 the `V' and `v' toggles.
 
+.TP 4
+\fB%CUU \*(Em \*(PU Utilization \fR
+A task's total \*(PU usage divided by its elapsed running time,
+expressed as a percentage.
+
+If a process currently displays high \*(PU usage, this field can help
+determine if such behavior is normal.
+Conversely, if a process has low \*(PU usage currently, %CUU may reflect
+historically higher demands over its lifetime.
+
 .TP 4
 \fB%MEM \*(Em Memory Usage (RES) \fR
 A task's currently resident share of available \*(MP.
@@ -969,6 +979,11 @@ By convention, this value equals the process ID (\*(Xa PID) of the first
 member of the session, called the session leader, which is usually the
 login shell.
 
+.TP 4
+\fBSTARTED \*(Em Start Time \fR
+The length of time since system boot when a process started.
+Thus, the most recently started task will display the largest time interval.
+
 .TP 4
 \fBSUID \*(Em Saved User Id \fR
 The\fI saved\fR user ID.