<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">=begin html

&lt;a href="https://travis-ci.org/rocky/p5-Term-ReadLine-Perl5"&gt;&lt;img src="https://travis-ci.org/rocky/p5-Term-ReadLine-Perl5.png"&gt;&lt;/a&gt;

=end html

=encoding utf8

=head1 NAME

Term::ReadLine::Perl5 - A Perl5 implementation GNU Readline

=head1 SYNOPSIS

  use Term::ReadLine::Perl5;
  $term = new Term::ReadLine::Perl5 'ProgramName';
  while ( defined ($_ = $term-&gt;readline('prompt&gt;')) ) {
    ...
  }

=head1 DESCRIPTION

=head2 Overview

This is a implementation of the GNU Readline/History Library written
in Perl5.

GNU Readline reads lines from an interactive terminal with I&lt;emacs&gt; or
I&lt;vi&gt; editing capabilities. It provides as mechanism for saving
history of previous input.

This package typically used in command-line interfaces and REPLs (Read,
Eval, Print, Loop).

See L&lt;Term::ReadLine::Perl5&gt; for details on the API.

=head2 Demo program

Another package, L&lt;Term::ReadLine::Perl5::Demo&gt; is available to let
you run I&lt;Term::ReadLine::Perl5&gt; to experiment with its capabilities
and show how to use the API.

=head1 INSTALL

To install this module type:

    perl Build.PL
    make
    # for interactive testing:
    make test
    # for non-interactive testing
    AUTOMATED_TESTING=1 make test
    make install # might need sudo make install

=head1 DEVELOPMENT HISTORY

The first implementation was in Perl4 (mostly) by Jeffrey
Friedl. He referenced FSF the code Roland Schemers F&lt;line_edit.pl&gt;.

Ilya Zakharevich turned this into a Perl5 module called
L&lt;Term::ReadLine::Perl&gt;. Some of the changes he made include using
L&lt;Term::ReadKey&gt; if present, and made this work under I&lt;xterm&gt;. The
file F&lt;Term/ReadLine/Perl5/CHANGES&gt; up to but not including version
1.04 contains a list of his changes.

Starting with version 1.04 Rocky Bernstein forked the code, adding GNU
readline history. He put it into a public git repository (github) and
also started modernizing it and doing the things CPAN prefers,
including adding POD documentation and non-interactive tests, removing
(some) type globs, and respecting CPAN module namespaces.

=head1 BUGS

Bugs are accepted via the L&lt;github issues
tracker|https://github.com/rocky/p5-Term-ReadLine-Perl5/issues&gt;.

=head1 LICENSE

Copyright (c) 2013-2014 Rocky Bernstein.
Copyright (c) 1995 Ilya Zakharevich.

This program is distributed WITHOUT ANY WARRANTY, including but not
limited to the implied warranties of merchantability or fitness for a
particular purpose.

The program is free software. You may distribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation (either version 2 or any later version) and
the Perl Artistic License as published by O�筻eilly Media, Inc. Please
open the files named gpl-2.0.txt and Artistic for a copy of these
licenses.

=cut
</pre></body></html>