---
name: "IO::Pager::Page"
section: "3pm"
platform: "linux"
package: "perl-io-pager"
version: "2.10-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/IO::Pager::Page"
---

# IO::Pager::Page(3pm)

Emulate IO::Page, pipe STDOUT to a pager if STDOUT is a TTY

## NAME

IO::Pager::Page - Emulate IO::Page, pipe STDOUT to a pager if STDOUT is a TTY

## SYNOPSIS

Pipes STDOUT to a pager if STDOUT is a TTY

## DESCRIPTION

IO::Pager was designed to programmatically decide whether or not to point the STDOUT file handle into a pipe to program specified in the *PAGER* environment variable or one of a standard list of pagers.

## USAGE

```
  BEGIN {
    use IO::Pager::Page;
    # use I::P::P first, just in case another module sends output to STDOUT
  }
  print<<HEREDOC;
  ...
  A bunch of text later
  HEREDOC
```

If you wish to forgo the potential for a *Broken Pipe* foible resulting from the user exiting the pager prematurely, load IO::Pager::Page like so:

```
  use IO::Pager::Page hush=>1;
```

## SEE ALSO

IO::Page, IO::Pager, IO::Pager::Unbuffered, IO::Pager::Buffered

## AUTHOR

Jerrad Pierce \<jpierce@cpan.org\>

Florent Angly \<florent.angly@gmail.com\>

This module inspired by Monte Mitzelfelt's IO::Page 0.02

## COPYRIGHT AND LICENSE

Copyright (C) 2003-2015 Jerrad Pierce

- •

  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.