49 lines
935 B
Groff
49 lines
935 B
Groff
|
.Dd May 17, 2024
|
||
|
|
.Dt TS 1
|
||
|
|
.Os
|
||
|
|
.Sh NAME
|
||
|
|
.Nm p
|
||
|
|
.Nd Paginate
|
||
|
|
.Sh SYNOPSIS
|
||
|
|
.Nm
|
||
|
|
.Op Fl number
|
||
|
|
.Ar
|
||
|
|
.Sh DESCRIPTION
|
||
|
|
.Nm
|
||
|
|
copies its standard input, or the named files if given,
|
||
|
|
to its standard output,
|
||
|
|
stopping at the end of every page and at the end of each file.
|
||
|
|
The special file name
|
||
|
|
.Pa -
|
||
|
|
can be used to refer explicitly to the standard input.
|
||
|
|
.Pp
|
||
|
|
Page size is defined by the
|
||
|
|
.Ev LINES
|
||
|
|
environment variable.
|
||
|
|
If not defined, a default page size of 22 will be used.
|
||
|
|
The page size can be overriden with the numeric option.
|
||
|
|
.Pp
|
||
|
|
While waiting for a newline,
|
||
|
|
.Nm
|
||
|
|
interprets the commands:
|
||
|
|
.Bl -tag
|
||
|
|
.It !
|
||
|
|
Run the rest of the line as a shell command.
|
||
|
|
.It q
|
||
|
|
Quit.
|
||
|
|
.El
|
||
|
|
Any other input will show the next input page.
|
||
|
|
.Sh ENVIRONMENT
|
||
|
|
.Bl -tag -width LINES
|
||
|
|
.It Ev LINES
|
||
|
|
Number of lines of the terminal.
|
||
|
|
.El
|
||
|
|
.Sh EXIT STATUS
|
||
|
|
.Ex -std
|
||
|
|
.Sh HISTORY
|
||
|
|
This is a reimplementation of Plan 9's
|
||
|
|
.Nm
|
||
|
|
pager.
|
||
|
|
.Sh AUTHORS
|
||
|
|
.An Adolfo Perez Alvarez Aq Mt adolfopa@sdf.org
|