NAME

tp - a pure perl pager

SYNOPSIS

tp -[JSenrs] [-cols] [-l[STR]] [-j|+ #] [-p|+/ STR]

OPTIONS

-e

Exit at end of file.

-f[STR]

If defined, the pager will pause when the character sequence specified by STR is encountered in the input text. The default value when enabled is formfeed i.e; ^L; in order to mimic traditional behavior of "1" in more.

You might also supply a regular expression as STR e.g;

tp -f '[ie]t'
-J

Add a column with markers indicating which row match a search expression.

-n

Display line numbering. Toggleable at run time with #.

-r

Send raw control characters from input unadulterated to the terminal. By default, chracters other than tab and newline will be converted to caret notation e.g; ^@ for null or ^L for form feed.

-s

Squeeze multiple blank lines into one.

-S

Do not fold long lines.

-cols

Set the number of columns for the pager.

If absent, the terminal is queried directly with Term::ReadKey if loaded or stty or tput, and if these fail it defaults to 80.

User Interface

h - help
q - close
r or C-l - refresh
ENTER or down arrow - scroll down one line
d - scroll down one half page
SPACE or C-v - scroll down one page
b or M-v - scroll up one page
u - scroll up one half page
y or up arrow - scroll up one line
g or < - scroll to top
G or > - scroll to bottom
\d+ - jump to line number
left arrow - scroll left
right arrow - scroll right
/ - search forward
? - search backward
n or P - next match
p or N - previous match
# - toggle line-numbering
S - toggle folding
C - toggle raw/cooked output
m - save mark
' - goto mark

Special marks

^ Beginning of file
$ End of file
' Previous location
" List user-created marks

ENVIRONMENT

tp checks the LESS, MORE, TERM and TERMCAP variables.

SEE ALSO

IO::Pager::Perl, less(1)

AUTHORS

Jerrad Pierce jpierce@cpan.org

LICENSE