IO::Pager & IO::Pager::Perl ===================== IO::Pager - Select a pager and pipe text to it if destination is a TTY IO::Pager::Perl - A pure perl pager engine IO::Pager::Perl is used in the IO::Pager::less IO::Pager subclass, but is also a free-standing library ready to be incorporated into other code. IO::Pager is lightweight and can be used to locate an available pager and set the PAGER environment variable sanely or as a factory for creating objects defined elsewhere such as IO::Pager::Buffered, IO::Pager::Unbuffered, and IO::Pager::less which provides a pure perl pager called tp. IO::Pager subclasses are designed to programmatically decide whether or not to pipe a filehandle's output to a program specified in PAGER. Subclasses may inherit from IO::Pager, and implement the IO handle methods desired. INSTALLATION To install this module type the following: perl Makefile.PL make # Run non-interactive tests make test # Run interactive tests perl -Mblib test.pl interactive make install DEPENDENCIES Multiple core modules are used: base, Env, File::Spec, File::Which, IO::Handle, PerlIO, SelectSaver, Symbol, Text::Wrap, Tie::Handle Term::ReadKey is also require for IO::Pager::less, IO::Pager::Perl and tp. Win32::Console::ANSI, included in some distributions of Win32 perl like Strawberry is recommended on Windows for IO::Pager::less et al. to function. Test::More is used during the installation procedure. PORTABILITY IO::Pager is intended to be as portable as possible, I've tested it on numerous platform and perl version combinations. Most work fine though you may run into quirks, it tends to be happiest under perl built with perlio not stdio. COPYRIGHT AND LICENSE IO::Pager::Perl - Jerrad Pierce & Jeff Weisberg, Perl Artistic License All Else - Copyright (C) 2003-2020 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.