'\" t
.\"	vii - buffer and display outout
.\"	Copyright (C) 1991, 1995, 1999, 2005 Peter Miller
.\"
.\"	This program is free software; you can redistribute it and/or modify
.\"	it under the terms of the GNU General Public License as published by
.\"	the Free Software Foundation; either version 2 of the License, or
.\"	(at your option) any later version.
.\"
.\"	This program is distributed in the hope that it will be useful,
.\"	but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"	GNU General Public License for more details.
.\"
.\"	You should have received a copy of the GNU General Public License
.\"	along with this program; if not, write to the Free Software
.\"	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
.\"
.\" MANIFEST: description of the vii(1) command
.\"
.ds n) vii
.TH \*(n) 1 local
.SH NAME
\*(n) \- buffer and display output
.SH SYNOPSIS
.B \*(n)
[
.IR option ...
]
.br
.B \*(n)
.B -Help
.br
.B \*(n)
.B -VERSion
.SH DESCRIPTION
The \fI\*(n)\fP command
accepts input from the standard input and displays
pages of the input on the crt.
These pages are delimited by form-feeds (or EOF)
and only as much as will fit on the screen will be displayed.
.PP
The \fI\*(n)\fP command 
can also repeatedly execute a command,
and the most recent output is displayed.
.SH OPTIONS
The following options are understood:
.TP 8n
\fB-Execute\fP \fIstring\fP
The given string is executed.
The command should be in quotes.
.TP
\fB-Interval\fP \fInumber\fP
Commands executed with the
.B -Execute
option will be reexecuted after the given interval in seconds.
.TP
\fB-Terminal\fP \fIstring\fP
Use the terminal type given,
rather than the type given in the
.I TERM
environment variable.
.TP 8n
.B -Help
Display some help on how to used the
.IR \*(n) (1)
command.
.TP 8n
.B -VERSion
Display the versin of the
.IR \*(n) (1)
command.
.so o__rules.so
.SH COMMANDS
The following commands may be used to navigate the displayed text
.TP 8n
q Q
Quit out of
.IR \*(n) (1).
As much of possible of the display is preserved.
The interrupt key (usually ^C) will also cause
.IR \*(n) (1)
to quit.
.TP 8n
^L ^R
Redraw the screen.
This can be useful if a background process has overwritten the display.
.TP 8n
j ^E CR
Scroll down one line.
.TP 8n
k ^Y
Scroll up one line.
.TP 8n
J ^F SP
Scroll down one screen of text.
.TP 8n
K ^B
Scroll up one screen of text.
.TP 8n
c C ^C
Show the date and time in the top right corner of the screen.
.TP 8n
t T ^T
Show the time in the top right corner of the screen.
.TP 8n
d D ^D
Show the date in the top right corner of the screen.
.TP 8n
p P ^P
Show the line position in the top right corner of the screen.
.SH EXAMPLES
To display the process state every 15 seconds,
 use the following command:
.RS
.ft CW
.nf
\*(n) -e "ps axu" -i 15
.fi
.ft R
.RE
If your shell does not have aliases,
this shell script will do much the same thing:
.RS
.ft CW
.nf
#!/bin/sh
while :
do
	ps axu
	echo | tr '\e12' '\e14'
	sleep 15
done | \*(n)
.fi
.ft R
.RE
If you don't have a Berkeley style
.IR ps (1)
command, you will need to supply options as appropriate.
.so z_exit.so
.so copyright.so