-- Indented-text --
$Id: README,v 1.30 2010/05/02 10:38:53 hiroo Exp $

Term::ReadLine::Gnu --- GNU Readline Library Wrapper Module

Copyright (c) 2010 Hiroo Hayashi. All rights reserved. 

        This program is free software; you can redistribute it and/or
        modify it under the same terms as Perl itself.
Description
        Term::ReadLine::Gnu (TRG) is an implementation of the
        interface to the GNU Readline Library.  This module gives you
        input line editing facility, input history management
        facility, word completion facility, etc.  It uses the real GNU
        Readline Library and has the interface with the almost all
        variables and functions which are documented in the GNU
        Readline/History Library.  So you can program your custom
        editing function, your custom completion function, and so on
        with Perl.  TRG may be useful for a C programmer to prototype
        a program which uses the GNU Readline Library.

        TRG is upper compatible with Term::ReadLine included in Perl
        distribution.  Term::ReadLine uses TRG automatically when TRG
        is available.  You can enjoy full line editing feature with
        Perl debugger which use Term::ReadLine with no patch.

        Ilya Zakharevich distributes his implementation,
        Term::ReadLine::Perl, which bases on Jeffrey Friedl's
        readline.pl.  His module works very well, and is easy to
        install because it is written by only Perl.  I am trying to
        make my module compatible with his.  He gives useful advises
        for me.  Unfortunately readline.pl simulated old GNU Readline
        library before TRG was born.  For example, it was not 8 bit
        clean and it warns to the variables in ~/.inputrc which it did
        not know yet.  We Japanese usually use 8 bit characters, so
        this was bad feature for me.  I could make a patch for these
        problems but I had interest with C interface facility and
        dynamic loading facility of Perl, so I thought it was a good
        chance for me to study them.  Then I made this module instead
        of fixing his module.
Prerequisites

You must have Perl 5.7 or later. If you have to use old Perl for some reason, use Term::ReadLine::Gnu 1.09. (I recommend you to use newer Perl.) 

        You must have GNU Readline Library Version 2.1 or later.  See
        INSTALL for more detail.

        A report said GNU Readline Library might not work with perl with
        sfio.  Since I do not have sfio library, I am not sure.

How to build/install:

See INSTALL.

Bugs

There may be many bugs in both programs and documents (especially in English grammar). Comments and bug reports are very welcome.

Author

Hiroo Hayashi <hiroo.hayashi@computer.org>

Revision History:

1.20 2010-05-02

1.19 2009-03-21

1.18 2009-02-27

1.17 2008-02-07

1.16 2006-04-02

1.15 2004-10-17

1.14 2003-03-16

1.13 2002-07-27

1.12 2002-03-30

1.11 2001-10-27

1.10 2001-04-22

1.09 2000-04-04

1.08 1999-12-30

1.07 1999-07-19

1.06 1999-05-05

1.05 1999-04-04

search text of list_completion is quoted

rl_get_all_function_names() 

          eg/pftp
                password input is now invisible.
                displaying of completion candidates are improved by using
                completion_display_matches_hook.
        
        - internal changes
                Perl code for Term::ReadLine::Gnu::XS package are moved
                into separate file Gnu/XS.pm and `AutoSplit'ed.
        
                replace operate_and_get_next() to one borrowed from bash.

1.04 1999-02-23

1.03 1998-09-27

1.02 1998-08-14

1.01 1998-05-13

1.00 1998-04-15

0.10 1998-03-31

0.09 Mon Aug 25 00:33:29 1997

0.08 Sun Apr 13 23:24:52 1997

0.07 Wed Mar 19 02:26:06 1997

0.06 Wed Feb 5 01:26:27 1997

0.05 Sat Jan 25 00:06:56 1997

0.04 Thu Jan 23 00:25:45 1997

0.03 Sun Nov 24 23:34:27 1996

0.02 Thu Nov 21 00:22:11 1996

0.01 Wed Nov 20 01:14:09 1996