1TP(1) User Contributed Perl Documentation TP(1)
2
6 tp - a pure perl pager
7
9 tp -[JSenrs] [-cols] [-f STR] [-j|+ #] [-p|+/ STR] [FILE]...
10
12 -e Exit at end of file.
13 -f STR
15 If defined, the pager will pause when the character sequence
16 specified by STR is encountered in the input text.
17 The default value when enabled is formfeed i.e; ^L; in order to
19 mimic traditional behavior of "1" in more, but due to the
20 pecularities of Getopt::Long> you need to use the -- argument
21 separator in order to to trigger this e.g;
22 tp -f -- foo #pauses on lines in foo with "^L" in them
24 You might also supply a regular expression as STR e.g;
26 tp -f '[ie]t' bar #pauses on lines in bar with "it" or "et" in them
28 -J Add a column with markers indicating which lines match a search
30 expression.
31 -n Display line numbering. Toggleable at run time with #.
33 -r Send raw control characters from input unadulterated to the
35 terminal. By default, chracters other than tab and newline will be
36 converted to caret notation e.g; ^@ for null or ^L for form feed.
37 -s Squeeze multiple blank lines into one.
39 -S Do not fold long lines.
41 -[ or --scrollbar
43 Display an interactive scrollbar in the right-most column.
44 -$ or --tail
46 Keep checking the displayed file for new content. Only available
47 when paging a single file.
48 --cols
50 Set the number of columns for the pager.
51 If absent, the terminal is queried directly with Term::ReadKey if
53 loaded or "stty" or "tput", and if these fail it defaults to 80.
54
56 "C-" is Control, "M-" is Meta/Alt, "S-" is Shift, and "\d+" is a
57 sequence of digits
58 General
60 help - "h" or "H"
61 close - "q" or "Q" or ":q" or ":Q"
62 refresh - "r" or "C-l" or "C-R"
63 flush buffer - "R"
64 save buffer - ":w"
65 open file - ":e"
66 Navigation
68 down one line - "ENTER" or "e" or "j" or "J" or "C-e" or "C-n" or "down
69 arrow"
70 down half page - "d" or "C-d"
71 down one page - "SPACE" "f" or "z" or "C-f" or "C-v" or "M-space" or
72 "PgDn"
73 up one page - "b" or "w" or "C-b" or "M-v" or "PgUp"
74 up half page - "u" or "C-u"
75 up one line - "k" or "y" or "K" or "Y" or "C-K" or "C-P" or "C-Y" or
76 "up arrow"
77 to bottom - "G" or "$" or ">" or "M->" or "End"
78 to top - "g" or "<" or "M-<"
79 left one tab - "left arrow"
80 left half screen - "S-left arrow"
81 right one tab - "right arrow"
82 right half screen - "S-right arrow"
83 jump to line number - "\d+"
84 next file - ":n" or "S-M-right arrow"
85 previous file - ":p" or "S-M-left arrow"
86 Bookmarks
88 Save mark - "m" or "Ins"
90 Goto mark - "'"
91 Special mark: Beginning of file - "^"
92 Special mark: End of file - "$"
93 Special mark: Previous location - "'"
94 Special mark: List user-created marks - """
95 Special mark: "\d" - Top of file \d when viewing multiple files
96 Search
98 forward - /
99 backward - ?
100 next match - n or P
101 previous match - p or N
102 grep (show only matching lines) - &
103
105 toggle line-numbering - #
106 toggle folding - S
107 toggle raw/cooked output - C
108
110 tp checks the LESS, MORE, TPOPT, TERM and TERMCAP variables.
111 The TPOPT variable is used to set options explicitly for tp, by
113 concatenating undecorated options together e.g; Sr for squished raw
114 output.
115 LESS and MORE are checked for options that tp supports, and if detected
117 they are enabled.
118
120 IO::Pager::Perl, less(1)
121
123 Jerrad Pierce jpierce@cpan.org
124
126 • Thou shalt not claim ownership of unmodified materials.
127 • Thou shalt not claim whole ownership of modified materials.
129 • Thou shalt grant the indemnity of the provider of materials.
131 • Thou shalt use and dispense freely without other restrictions.
133 Or, if you prefer:
135 This library is free software; you can redistribute it and/or modify it
137 under the same terms as Perl itself, either Perl version 5.0 or, at
138 your option, any later version of Perl 5 you may have available.
139perl v5.34.0 2022-01-21 TP(1)