1TP(1)                 User Contributed Perl Documentation                TP(1)
2
3
4

NAME

6       tp - a pure perl pager
7

SYNOPSIS

9           tp -[JSenrs] [-cols] [-f STR] [-j|+ #] [-p|+/ STR] [FILE]...
10

OPTIONS

12       -e  Exit at end of file.
13
14       -f STR
15           If defined, the pager will pause when the character sequence
16           specified by STR is encountered in the input text.
17
18           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
23               tp -f -- foo #pauses on lines in foo with "^L" in them
24
25           You might also supply a regular expression as STR e.g;
26
27               tp -f '[ie]t' bar #pauses on lines in bar with "it" or "et" in them
28
29       -J  Add a column with markers indicating which lines match a search
30           expression.
31
32       -n  Display line numbering. Toggleable at run time with #.
33
34       -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
38       -s  Squeeze multiple blank lines into one.
39
40       -S  Do not fold long lines.
41
42       -[ or --scrollbar
43           Display an interactive scrollbar in the right-most column.
44
45       -$ or --tail
46           Keep checking the displayed file for new content.  Only available
47           when paging a single file.
48
49       --cols
50           Set the number of columns for the pager.
51
52           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

User Interface

56       "C-" is Control, "M-" is Meta/Alt, "S-" is Shift, and "\d+" is a
57       sequence of digits
58
59   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
67   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
87       Bookmarks
88
89       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
97   Search
98       forward - /
99       backward - ?
100       next match - n or P
101       previous match - p or N
102       grep (show only matching lines) - &
103

Options

105       toggle line-numbering - #
106       toggle folding - S
107       toggle raw/cooked output - C
108

ENVIRONMENT

110       tp checks the LESS, MORE, TPOPT, TERM and TERMCAP variables.
111
112       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
116       LESS and MORE are checked for options that tp supports, and if detected
117       they are enabled.
118

SEE ALSO

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

AUTHORS

123           Jerrad Pierce jpierce@cpan.org
124

LICENSE

126       •   Thou shalt not claim ownership of unmodified materials.
127
128       •   Thou shalt not claim whole ownership of modified materials.
129
130       •   Thou shalt grant the indemnity of the provider of materials.
131
132       •   Thou shalt use and dispense freely without other restrictions.
133
134       Or, if you prefer:
135
136       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.
139
140
141
142perl v5.34.0                      2021-07-22                             TP(1)
Impressum