Index | Thread | Search

From:
Evan Silberman <evan@jklol.net>
Subject:
top.1: symbolize the names of columns
To:
tech@openbsd.org
Date:
Sun, 18 May 2025 22:48:44 -0700

Download raw body.

Thread
I was looking at top, was wondering what WAIT meant, typed `man top` and
then :t WAIT in the pager and got no results.

I can't think of a better mdoc macro for an element of an interactive
display than Sy; Ic seems worse. If none are appropriate we could
sprinkle Tg in this list but that seemed less desirable.


diff /usr/src
path + /usr/src
commit - 5d5504715671cd3636955b8ebd3cd34495f6646c
blob - 3f5aa686eb4bf0dfc7f0e78cbd9770f7c32b0efc
file + usr.bin/top/top.1
--- usr.bin/top/top.1
+++ usr.bin/top/top.1
@@ -432,27 +432,27 @@ This display is similar in spirit to
 but it is not exactly the same.
 The following fields are displayed:
 .Bl -tag -width USERNAME -offset indent
-.It PID
+.It Sy PID
 The process ID.
-.It USERNAME
+.It Sy USERNAME
 The name of the process's owner.
-.It TID
+.It Sy TID
 The thread ID, used instead of USERNAME if
 .Fl H
 is specified.
-.It UID
+.It Sy UID
 Used instead of USERNAME if
 .Fl u
 is specified.
-.It PRI
+.It Sy PRI
 The current priority of the process.
-.It NICE
+.It Sy NICE
 The nice amount (in the range \-20 to 20).
-.It SIZE
+.It Sy SIZE
 The total size of the process (the text, data, and stack segments).
-.It RES
+.It Sy RES
 The current amount of resident memory.
-.It STATE
+.It Sy STATE
 The current state (one of
 .Li start ,
 .Li run ,
@@ -465,19 +465,19 @@ or
 .Li onproc ) .
 On multiprocessor systems, this is followed by a slash and the CPU
 number on which the process is bound.
-.It WAIT
+.It Sy WAIT
 A description of the wait channel the process is sleeping on if it's
 asleep.
-.It RTABLE
+.It Sy RTABLE
 The routing table, used instead of WAIT if
 .Fl t
 is specified.
-.It TIME
+.It Sy TIME
 The number of system and user CPU seconds that the process has used.
-.It CPU
+.It Sy CPU
 The raw percentage of CPU usage and the default field on which the
 display is sorted.
-.It COMMAND
+.It Sy COMMAND
 The name (and arguments if
 .Fl C
 is specified) of the command that the process is currently running.