The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Term::Pager - Page through text, a screenful at a time, like more or less

SYNOPSIS

    use Term::Pager;

    my $t = Term::Pager->new( rows => 25, cols => 80 );
    $t->add_text( $text );
    $t->more();

DESCRIPTION

This is a module for paging through text one screenful at a time. It supports the features you expect, including backwards movement and searching. It uses the keys you expect.

USAGE

Create the Pager

    $t = Term::Pager->new( option => value, ... );

If no options are specified, sensible default values will be used. The following options are recognized:

rows

The number of rows on your terminal. This defaults to 25.

cols

The number of columns on your terminal. This defaults to 80.

speed

The speed (baud rate) of your terminal. Will default to a sensible value.

Adding Text

You will need some text to page through. You can specify text as as a parameter to the constructor:

    text => $text

Or add text later:

    $t->add_text( $text );

FEATURES

This code uses termcap. If the termcap entry for your ancient esoteric terminal is wrong or incomplete, this module may either fill your screen with unintelligible gibberish, or drop back to a feature-free mode.

SEE ALSO

    Term::Cap, termcap(5), more(1), less(1)
    Yellowstone National Park

AUTHOR

    Jeff Weisberg - http://www.tcp4me.com