Imported Upstream version 0.8.3upstream/0.8.3

1 files changed, 142 insertions, 0 deletions

diff --git a/htop.1.in b/htop.1.in
new file mode 100644
index 0000000..6fb20f7
--- /dev/null
+++ b/htop.1.in
@@ -0,0 +1,142 @@
+.TH "htop" "1" "@PACKAGE_VERSION@" "Bartosz Fenski <fenio@o2.pl>" "Utils"
+.SH "NAME"
+htop \- interactive process viewer
+.SH "SYNTAX"
+.LP 
+.B htop 
+.SH "DESCRIPTION"
+.LP 
+This program is a free (GPL) ncurses-based process viewer. 
+.LP
+It is similar to top, but allows to scroll the list vertically and 
+horizontally to see all processes and their full command lines.
+.LP
+Tasks related to processes (killing, renicing) can be done without
+entering their PIDs.
+.br 
+.SH "COMMAND-LINE OPTIONS"
+.LP 
+The following flags are supported:
+.LP 
+.TP
+\fB\-d DELAY\fR
+Delay between updates, in tenths of seconds
+.TP
+\fB\-u USERNAME\fR
+Show only processes of a given user
+.TP
+\fB\-\-sort\-key COLUMN\fR
+Sort by this column (use --sort-key help for a column list)
+.PP
+.br 
+.SH "INTERACTIVE COMMANDS"
+.LP 
+The following commands are supported:
+.LP 
+.TP 5
+.B Arrows, PgUP, PgDn, Home, End
+Scroll process list.
+.TP
+.B Space
+"Tag": mark a process. Commands that can operate on multiple processes,
+like "kill", will then apply over the list of tagged processes, instead
+of the currently highlighted one.
+.TP
+.B U
+"Untag" all processes (remove all tags added with the Space key).
+.TP
+.B s
+Trace process system calls: if strace(1) is installed, pressing this key
+will attach it to the currently selected process, presenting a live
+update of system calls issued by the process.
+.TP
+.B l
+Display open files for a process: if lsof(1) is installed, pressing this key
+will display the list of file descriptors opened by the process.
+.TP
+.B F1, h
+Help screen
+.TP
+.B F2, S
+Setup screen. There you can configure meters displayed on the top side
+of the screen, as well as set various display options, choose among
+color schemes and select the layout of the displayed columns.
+.TP
+.B F3, /
+Incremental process search: type in part of a process command line and
+the selection highlight will be moved to it. While in search mode,
+pressing this key will cycle through matching occurrences.
+.TP
+.B F4, I
+Invert sort order: if sort order is increasing, switch to decreasing,
+and vice-versa.
+.TP
+.B F5, t
+Tree view: organize processes by parenthood, and layout the relations
+between them as a tree. Toggling the key will switch between tree and
+your previously selected sort view. Selecting a sort view will exit
+tree view.
+.TP
+.B F6, >
+Select field for sorting. The sort field is indicated by a
+highlight in the header.
+.TP
+.B F7, ], -
+Increase selected process priority (subtract from 'nice' value).
+This can be done by the superuser only.
+.TP
+.B F8, [, +
+Decrease selected process priority (add to 'nice' value)
+.TP
+.B F9, k
+"Kill" process: sends a signal which is selected in a menu, to one or a group
+of processes. If processes were tagged, sends the signal to all tagged processes.
+If none is tagged, sends to the currently selected process.
+.TP
+.B F10, q
+Quit
+.TP
+.B a (on multiprocessor machines)
+Set CPU affinity: mark which CPUs a process is allowed to use.
+.TP
+.B u
+Show only processes owned by a specified user.
+.TP
+.B M
+Sort by memory usage (top compatibility key).
+.TP
+.B P
+Sort by processor usage (top compatibility key).
+.TP
+.B T
+Sort by time (top compatibility key).
+.TP
+.B F
+"Follow" process: if the sort order causes the currently selected process
+to move in the list, make the selection bar follow it. This is useful for
+monitoring a process: this way, you can keep a process always visible on
+screen. When a movement key is used, "follow" loses effect.
+.TP
+.B K
+Hide kernel threads: prevent the threads belonging the kernel to be
+displayed in the process list. (This is a toggle key.)
+.TP
+.B H
+Hide user threads: on systems that represent them differently than ordinary
+processes (such as recent NPTL-based systems), this can hide threads from
+userspace processes in the process list. (This is a toggle key.)
+.TP
+.B Ctrl-L
+Refresh: redraw screen and recalculate values.
+.TP
+.B Numbers
+PID search: type in process ID and the selection highlight will be moved to it.
+.PD
+
+.SH "AUTHORS"
+.LP 
+htop is developed by Hisham Muhammad <loderunner@users.sourceforge.net>.
+.br
+This man page was written by Bartosz Fenski <fenio@o2.pl> for the 
+Debian GNU/Linux distribution (but it may be used by others), and
+updated by Hisham Muhammad.