--- top/top.1 +++ top/top.1 2012-06-01 14:25:06.216010097 +0000 @@ -23,7 +23,7 @@ .. \# Setup //////////////////////////////////////////////////////////////// \# ** Comment out '.nr' or set to 0 to eliminate WIDTH fiddlin' ! -.nr half_xtra 4 +.nr half_xtra 0 . .ll +(\n[half_xtra] + \n[half_xtra]) . @@ -46,15 +46,15 @@ .ds F \fIOff\fR .ds O \fIOn\fR . -.ds AK asterisk (\'*\') +.ds AK asterisk ('*') .ds AM alternate\-display mode .ds AS auxiliary storage .ds CF configuration file -.ds CG \'current\' window/field group +.ds CG 'current' window/field group .ds CI interactive command .ds CO command\-line option .ds CT command toggle -.ds CW \'current\' window +.ds CW 'current' window .ds FG field group .ds FM full\-screen mode .ds KA arrow key @@ -818,7 +818,7 @@ Use either of these keys if you have a l to see current status, .TP 7 -\ \ \'\fB?\fR\' | \'\fBh\fR\' :\fIHelp \fR +\ \ '\fB?\fR' | '\fBh\fR' :\fIHelp \fR There are two help levels available. The first will provide a reminder of all the basic \*(CIs. If \*(We is\fI secured\fR, that screen will be abbreviated. @@ -827,7 +827,7 @@ Typing 'h' or '?' on that help screen wi those \*(CIs applicable to \*(AM. .TP 7 -\ \ \'\fB=\fR\' :\fIExit-Task-Limits \fR +\ \ '\fB=\fR' :\fIExit-Task-Limits \fR Removes restrictions on which tasks are shown. This command will reverse any 'i' (idle tasks) and 'n' (max tasks) commands that might be active. @@ -843,13 +843,13 @@ vertical and horizontal scrolling. When operating in \*(AM this command has a broader meaning. .TP 7 -\ \ \'\fBA\fR\' :\fIAlternate-Display-Mode\fR toggle \fR +\ \ '\fBA\fR' :\fIAlternate-Display-Mode\fR toggle \fR This command will switch between \*(FM and \*(AM. \*(XT 5. ALTERNATE\-DISPLAY Provisions and the 'g' \*(CI for insight into \*(CWs and \*(FGs. .TP 7 -\ \ \'\fBB\fR\' :\fIBold-Disable/Enable\fR toggle \fR +\ \ '\fBB\fR' :\fIBold-Disable/Enable\fR toggle \fR This command will influence use of the 'bold' terminfo capability and alters\fB both\fR the \*(SA and \*(TA for the \*(CW. While it is intended primarily for use with dumb terminals, it can be @@ -861,7 +861,7 @@ Thus, unless the 'x' and/or 'y' toggles there will be no visual confirmation that they are even on. .TP 7 -*\ \'\fBd\fR\' | \'\fBs\fR\' :\fIChange-Delay-Time-interval \fR +*\ '\fBd\fR' | '\fBs\fR' :\fIChange-Delay-Time-interval \fR You will be prompted to enter the delay time, in seconds, between display updates. @@ -875,26 +875,26 @@ If at any time you wish to know the curr help and view the system summary on the second line. .TP 7 -\ \ \'\fBg\fR\' :\fIChoose-Another-Window/Field-Group \fR +\ \ '\fBg\fR' :\fIChoose-Another-Window/Field-Group \fR You will be prompted to enter a number between 1 and 4 designating the \*(FG which should be made the \*(CW. You will soon grow comfortable with these 4 windows, especially after experimenting with \*(AM. .TP 7 -\ \ \'\fBH\fR\' :\fIThreads-mode\fR toggle \fR +\ \ '\fBH\fR' :\fIThreads-mode\fR toggle \fR When this toggle is \*O, individual threads will be displayed for all processes in all visible \*(TWs. Otherwise, \*(We displays a summation of all threads in each process. .TP 7 -\ \ \'\fBI\fR\' :\fIIrix/Solaris-Mode\fR toggle \fR +\ \ '\fBI\fR' :\fIIrix/Solaris-Mode\fR toggle \fR When operating in 'Solaris mode' ('I' toggled \*F), a task's \*(Pu usage will be divided by the total number of \*(PUs. After issuing this command, you'll be told the new state of this toggle. .TP 7 -*\ \'\fBk\fR\' :\fIKill-a-task \fR +*\ '\fBk\fR' :\fIKill-a-task \fR You will be prompted for a PID and then the signal to send. The default signal, as reflected in the prompt, is SIGTERM. However, you can send any signal, via number or name. @@ -905,24 +905,24 @@ depending on your progress: 2) at the signal prompt, type 0 .TP 7 -\ \ \'\fBq\fR\' :\fIQuit \fR +\ \ '\fBq\fR' :\fIQuit \fR .TP 7 -*\ \'\fBr\fR\' :\fIRenice-a-Task \fR +*\ '\fBr\fR' :\fIRenice-a-Task \fR You will be prompted for a PID and then the value to nice it to. Entering a positive value will cause a process to lose priority. Conversely, a negative value will cause a process to be viewed more favorably by the kernel. .TP 7 -\ \ \'\fBW\fR\' :\fIWrite-the-Configuration-File \fR +\ \ '\fBW\fR' :\fIWrite-the-Configuration-File \fR This will save all of your options and toggles plus the current display mode and delay time. By issuing this command just before quitting \*(We, you will be able restart later in exactly that same state. .TP 7 -\ \ \'\fBZ\fR\' :\fIChange-Color-Mapping +\ \ '\fBZ\fR' :\fIChange-Color-Mapping This key will take you to a separate screen where you can change the colors for the \*(CW, or for all windows. For details regarding this \*(CI \*(Xt 4d. COLOR Mapping. @@ -943,12 +943,12 @@ These commands always impact just the \* \*(CWs and \*(FGs. .TP 7 -\ \ \'\fBl\fR\' :\fILoad-Average/Uptime\fR toggle \fR +\ \ '\fBl\fR' :\fILoad-Average/Uptime\fR toggle \fR This is also the line containing the program name (possibly an alias) when operating in \*(FM or the \*(CW name when operating in \*(AM. .TP 7 -\ \ \'\fBt\fR\' :\fITask/Cpu-States\fR toggle \fR +\ \ '\fBt\fR' :\fITask/Cpu-States\fR toggle \fR This command affects from 2 to many \*(SA lines, depending on the state of the '1' toggle and whether or not \*(We is running under true SMP. @@ -956,7 +956,7 @@ This portion of the \*(SA is also influe as reflected in the total label which shows either 'Tasks' or 'Threads'. .TP 7 -\ \ \'\fB1\fR\' :\fISingle/Separate-Cpu-States\fR toggle \fR +\ \ '\fB1\fR' :\fISingle/Separate-Cpu-States\fR toggle \fR This command affects how the 't' command's Cpu States portion is shown. Although this toggle exists primarily to serve massively-parallel SMP machines, it is not restricted to solely SMP environments. @@ -967,7 +967,7 @@ Otherwise, each \*(Pu is displayed separ up to available screen height. .TP 7 -\ \ \'\fBm\fR\' :\fIMemory/Swap-Usage\fR toggle \fR +\ \ '\fBm\fR' :\fIMemory/Swap-Usage\fR toggle \fR This command affects the two \*(SA lines dealing with physical and virtual memory. @@ -992,12 +992,12 @@ The following commands will also be infl global 'B' (bold enable) toggle. .TP 7 -\ \ \'\fBb\fR\' :\fIBold/Reverse\fR toggle \fR +\ \ '\fBb\fR' :\fIBold/Reverse\fR toggle \fR This command will impact how the 'x' and 'y' toggles are displayed. Further, it will only be available when at least one of those toggles is \*O. .TP 7 -\ \ \'\fBx\fR\' :\fIColumn-Highlight\fR toggle \fR +\ \ '\fBx\fR' :\fIColumn-Highlight\fR toggle \fR Changes highlighting for the current sort field. If you forget which field is being sorted this command can serve as a quick visual reminder, providing the sort field is being displayed. @@ -1006,7 +1006,7 @@ The sort field might\fI not\fR be visibl 2) the 'f' \*(CI turned it \*F .TP 7 -\ \ \'\fBy\fR\' :\fIRow-Highlight\fR toggle \fR +\ \ '\fBy\fR' :\fIRow-Highlight\fR toggle \fR Changes highlighting for "running" tasks. For additional insight into this task state, \*(Xt 3a. DESCRIPTIONS of Fields, the 'S' field (Process Status). @@ -1015,7 +1015,7 @@ Use of this provision provides important The only costs will be a few additional tty escape sequences. .TP 7 -\ \ \'\fBz\fR\' :\fIColor/Monochrome\fR toggle \fR +\ \ '\fBz\fR' :\fIColor/Monochrome\fR toggle \fR Switches the \*(CW between your last used color scheme and the older form of black-on-white or white-on-black. This command will alter\fB both\fR the \*(SA and \*(TA but does not affect @@ -1026,20 +1026,20 @@ the state of the 'x', 'y' or 'b' toggles .B CONTENT\fR of \*(TW .PD 0 .TP 7 -\ \ \'\fBc\fR\' :\fICommand-Line/Program-Name\fR toggle \fR +\ \ '\fBc\fR' :\fICommand-Line/Program-Name\fR toggle \fR This command will be honored whether or not the 'COMMAND' column is currently visible. Later, should that field come into view, the change you applied will be seen. .TP 7 -\ \ \'\fBf\fR\' | \'\fBF\fR\' :\fIFields-Management \fR +\ \ '\fBf\fR' | '\fBF\fR' :\fIFields-Management \fR These keys display a separate screen where you can change which fields are displayed, their order and also designate the sort field. For additional information on these \*(CIs \*(Xt 3b. MANAGING Fields. .TP 7 -\ \ \'\fBS\fR\' :\fICumulative-Time-Mode\fR toggle \fR +\ \ '\fBS\fR' :\fICumulative-Time-Mode\fR toggle \fR When 'Cumulative mode' is \*O, each process is listed with the \*(Pu time that it and its dead children have used. @@ -1055,7 +1055,7 @@ If you wish to know in advance whether o effect, simply ask for help and view the window summary on the second line. .TP 7 -\ \ \'\fBu\fR' | '\fBU\fR' :\fIShow-Specific-User-Only \fR +\ \ '\fBu\fR' | '\fBU\fR' :\fIShow-Specific-User-Only \fR You will be prompted for the\fB uid\fR or\fB name\fR of the user to display. The '-u' option matches on \fB effective\fR user whereas the '-U' option matches on\fB any\fR user (real, effective, saved, or filesystem). @@ -1068,7 +1068,7 @@ Later, if you wish to monitor all tasks command but just press at the prompt. .TP 7 -\ \ \'\fBV\fR' :\fIForest-View-Mode\fR toggle \fR +\ \ '\fBV\fR' :\fIForest-View-Mode\fR toggle \fR In this mode, processes are reordered according to their parents and the layout of the COMMAND column resembles that of a tree. In forest view mode it is still possible to toggle between program @@ -1084,7 +1084,7 @@ mode in the \*(CW. .B SIZE\fR of \*(TW .PD 0 .TP 7 -\ \ \'\fBi\fR\' :\fIIdle-Process\fR toggle \fR +\ \ '\fBi\fR' :\fIIdle-Process\fR toggle \fR Displays all tasks or just active tasks. When this toggle is \*F, tasks that have not used any \*(PU since the last update will not be displayed. @@ -1096,7 +1096,7 @@ If this command is applied to the last \ affect the window's size, as all prior \*(TDs will have already been painted. .TP 7 -\ \ \'\fBn\fR\' | \'\fB#\fR\' :\fISet-Maximum-Tasks \fR +\ \ '\fBn\fR' | '\fB#\fR' :\fISet-Maximum-Tasks \fR You will be prompted to enter the number of tasks to display. The lessor of your number and available screen rows will be used. @@ -1134,12 +1134,12 @@ The sort field might\fI not\fR be visibl 2) the 'f' \*(CI turned it \*F .TP 7 -\ \ \'\fB<\fR\' :\fIMove-Sort-Field-Left \fR +\ \ '\fB<\fR' :\fIMove-Sort-Field-Left \fR Moves the sort column to the left unless the current sort field is the first field being displayed. .TP 7 -\ \ \'\fB>\fR\' :\fIMove-Sort-Field-Right \fR +\ \ '\fB>\fR' :\fIMove-Sort-Field-Right \fR Moves the sort column to the right unless the current sort field is the last field being displayed. @@ -1150,14 +1150,14 @@ the current sort field is visible. .in .TP 7 -\ \ \'\fBf\fR\' | \'\fBF\fR\' :\fIFields-Management \fR +\ \ '\fBf\fR' | '\fBF\fR' :\fIFields-Management \fR These keys display a separate screen where you can change which field is used as the sort column, among other functions. This can be a convenient way to simply verify the current sort field, when running \*(We with column highlighting turned \*F. .TP 7 -\ \ \'\fBR\fR\' :\fIReverse/Normal-Sort-Field\fR toggle \fR +\ \ '\fBR\fR' :\fIReverse/Normal-Sort-Field\fR toggle \fR Using this \*(CI you can alternate between high-to-low and low-to-high sorts. .PP @@ -1236,7 +1236,7 @@ know what window is the \*(CW. .SS 5b. COMMANDS for Windows .\" ---------------------------------------------------------------------- .TP 7 -\ \ \'\fB-\fR\' | \'\fB_\fR\' :\fIShow/Hide-Window(s)\fR toggles \fR +\ \ '\fB-\fR' | '\fB_\fR' :\fIShow/Hide-Window(s)\fR toggles \fR The '-' key turns the \*(CW's \*(TD \*O and \*F. When \*O, that \*(TA will show a minimum of the columns header you've established with the 'f' \*(CI. @@ -1250,7 +1250,7 @@ If all 4 \*(TDs are currently visible, t as the only display element. .TP 7 -*\ \'\fB=\fR\' | \'\fB+\fR\' :\fIEqualize-(re-balance)-Window(s) \fR +*\ '\fB=\fR' | '\fB+\fR' :\fIEqualize-(re-balance)-Window(s) \fR The '=' key forces the \*(CW's \*(TD to be visible. It also reverses any 'i' (idle tasks), 'n' (max tasks) and 'u'/'U' (user filter) commands that might be active. @@ -1265,7 +1265,7 @@ except for the 'i' (idle tasks), 'n' (ma and scrolling \*(CIs. .TP 7 -*\ \'\fBA\fR\' :\fIAlternate-Display-Mode\fR toggle \fR +*\ '\fBA\fR' :\fIAlternate-Display-Mode\fR toggle \fR This command will switch between \*(FM and \*(AM. The first time you issue this command, all four \*(TDs will be shown. @@ -1273,7 +1273,7 @@ Thereafter when you switch modes, you wi chosen to make visible. .TP 7 -*\ \'\fBa\fR\' | \'\fBw\fR\' :\fINext-Window-Forward/Backward \fR +*\ '\fBa\fR' | '\fBw\fR' :\fINext-Window-Forward/Backward \fR This will change the \*(CW, which in turn changes the window to which commands are directed. These keys act in a circular fashion so you can reach any desired \*(CW @@ -1284,7 +1284,7 @@ whenever the \*(CW name loses its emphas the \*(TD is \*F and many commands will be restricted. .TP 7 -*\ \'\fBg\fR\' :\fIChoose-Another-Window/Field-Group \fR +*\ '\fBg\fR' :\fIChoose-Another-Window/Field-Group \fR You will be prompted to enter a number between 1 and 4 designating the \*(FG which should be made the \*(CW. @@ -1293,7 +1293,7 @@ In \*(AM, it is simply a less convenient commands. .TP 7 -\ \ \'\fBG\fR\' :\fIChange-Window/Field-Group-Name \fR +\ \ '\fBG\fR' :\fIChange-Window/Field-Group-Name \fR You will be prompted for a new name to be applied to the \*(CW. It does not require that the window name be visible (the 'l' toggle to be \*O). @@ -1301,8 +1301,8 @@ It does not require that the window name .IP "*" 3 The \*(CIs shown with an \*(AK have use beyond \*(AM. .Bd -literal -compact - \'=', 'A', 'g' are always available - \'a', 'w' act the same with color mapping + '=', 'A', 'g' are always available + 'a', 'w' act the same with color mapping \ and fields management .Ed @@ -1388,7 +1388,7 @@ available in \*(AM if the \*(CW's \*(TD You can use these \*(CIs to locate a task row containing a particular value. .TP 4 -'\fBL\fR\' :\fILocate-a-string\fR +'\fBL\fR' :\fILocate-a-string\fR You will be prompted for the case-sensitive string to locate starting from the current window coordinates. There are no restrictions on search string content. @@ -1401,7 +1401,7 @@ Keying with no input will effect a new search string is entered. .TP 4 -'\fB&\fR\' :\fILocate-next\fR +'\fB&\fR' :\fILocate-next\fR Assuming a search string has been established, \*(We will attempt to locate the next occurrence.