---
name: "tp"
section: "1p"
platform: "linux"
package: "perl-io-pager"
version: "2.10-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/tp"
---

# tp(1p)

a pure perl pager

## NAME

tp - a pure perl pager

## SYNOPSIS

```
    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 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.

- **-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.

## SEE ALSO

IO::Pager::Perl, [**less**(1)](/less/1.md)

## AUTHORS

```
    Jerrad Pierce jpierce@cpan.org
```

## 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.