tp1p
A pure perl pager
Usage
tp -
[JSenrs]
[-cols]
[-f
STR]
[{-j | +
#}]
[{-p | +/
STR}]
[FILE] ...
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, but due to the pecularities of Getopt::Long> you need to use the -- argument separator in order to to trigger this e.g;
tp -f -- foo #pauses on lines in foo with "^L" in themYou might also supply a regular expression as STR e.g;
tp -f '[ie]t' bar #pauses on lines in bar with "it" or "et" in them
-
-J -
Add a column with markers indicating which lines 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.
-
-[ or --scrollbar -
Display an interactive scrollbar in the right-most column.
-
-$ or --tail -
Keep checking the displayed file for new content. Only available when paging a single file.
-
--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
"C-" is Control, "M-" is Meta/Alt, "S-" is Shift, and "\d+" is a sequence of digits
General
- help - "h" or "H"
- close - "q" or "Q" or ":q" or ":Q"
- refresh - "r" or "C-l" or "C-R"
- flush buffer - "R"
- save buffer - ":w"
- open file - ":e"
Navigation
- down one line - "ENTER" or "e" or "j" or "J" or "C-e" or "C-n" or "down arrow"
- down half page - "d" or "C-d"
- down one page - "SPACE" "f" or "z" or "C-f" or "C-v" or "M-space" or "PgDn"
- up one page - "b" or "w" or "C-b" or "M-v" or "PgUp"
- up half page - "u" or "C-u"
- up one line - "k" or "y" or "K" or "Y" or "C-K" or "C-P" or "C-Y" or "up arrow"
- to bottom - "G" or "$" or ">" or "M->" or "End"
- to top - "g" or "<" or "M-<"
- left one tab - "left arrow"
- left half screen - "S-left arrow"
- right one tab - "right arrow"
- right half screen - "S-right arrow"
- jump to line number - "\d+"
- next file - ":n" or "S-M-right arrow"
- previous file - ":p" or "S-M-left arrow"
Bookmarks
- Save mark - "m" or "Ins"
- Goto mark - "'"
- Special mark: Beginning of file - "^"
- Special mark: End of file - "$"
- Special mark: Previous location - "'"
- Special mark: List user-created marks - """
- Special mark: "\d" - Top of file \d when viewing multiple files
Search
- forward - /
- backward - ?
- next match - n or P
- previous match - p or N
- grep (show only matching lines) - &
Options
- toggle line-numbering - #
- toggle folding - S
- toggle raw/cooked output - C
Environment
tp checks the LESS, MORE, TPOPT, TERM and TERMCAP variables.
The TPOPT variable is used to set options explicitly for tp, by concatenating undecorated options together e.g; Sr for squished raw output.
LESS and MORE are checked for options that tp supports, and if detected they are enabled.