TP(1)

💖 TP(1) 💖

okay so welcome to TP(1), bestie — a User Contributed Perl Documentation moment for tp, the pure perl pager. No cap, this page is your group-chat cheat sheet for paging files like a main character. 💅

🌸 NAME 🌸

tp — a pure perl pager. That's the whole name section, iconic and concise.

✨ SYNOPSIS ✨

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

Yes bestie, that line is literally the whole vibe check for how you call it.

💅 OPTIONS 💅

• -e — Exit at the end of the file. Bye at EOF, periodt.
• -f STR — If STR is defined, the pager pauses when the character sequence specified by STR is encountered in the input text. When enabled, the default value is formfeed, i.e. ^L; that's to mimic the traditional behavior of "1" in more, but because of the peculiarities of Getopt::Long you need to use the -- argument separator to trigger this, e.g.:

tp -f -- foo #pauses on lines in foo with "^L" in them

You 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. Search girlies stay winning.
• -n — Display line numbering. Toggleable at run time with #.
• -r — Send raw control characters from input unadulterated to the terminal. By default, characters other than tab and newline are converted to caret notation, e.g. ^@ for null or ^L for form feed.
• -s — Squeeze multiple blank lines into one. Minimalism.
• -S — Do not fold long lines. Let them stretch, long-line main character energy.
• -[, --scrollbar — Display an interactive scrollbar in the right-most column.
• -$, --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 🫶

Quick decoder ring, bestie: C- is Control, M- is Meta/Alt, S- is Shift, and \d+ is a sequence of digits. iykyk.

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.

🔥 SEE ALSO 🔥

IO::Pager::Perl, less(1). That's the crossover episode.

👑 AUTHORS 👑

Jerrad Pierce jpierce@cpan.org — the author, slay.

🎀 LICENSE 🎀

• Thou shalt not claim ownership of unmodified materials.
• Thou shalt not claim whole ownership of modified materials.
• Thou shalt grant the indemnity of the provider of materials.
• Thou shalt use and dispense freely without other restrictions.

Or, if you prefer:

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.0 or, at your option, any later version of Perl 5 you may have available.

---

💖 That's the TP(1) manual page, bestie — brought to you by perl v5.42.0 and dated 2025-12-14. Now go forth and page like the icon you are. 💅✨