IO::Pager::Page

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.