rlwrap v 0.16  August 18 2003

* WHAT IT IS: 

rlwrap is a 'readline wrapper', a small utility that uses the GNU
readline library to allow the editing of keyboard input for any
command. I couldn't find anything like it when I needed it, so I wrote
this one back in 1999.  By now, there are a number of good readline
wrappers around, like rlfe, distributed as part of the GNU readline
library, and cle (http://kaolin.unice.fr/Cle/).

rlwrap should be especially useful when you need user-defined (by way
of completion word lists) completion and persistent history. Moreover,
it should be portable across a fairly wide range of Unix systems.


* HOW TO USE IT:

Instead of 

$ <command> <args>

do

$ rlwrap [-options] <command> <args>

You then can edit <command>'s input and recall the input history using
the arrow keys.  Input history is remembered accross invocations,
separately for different <command>s Typing !<prefix><TAB> will recall
the last input line starting with <prefix>, CTRL-R will search the
input history.  With the -r and -f options you can specify the list of
words which rlwrap will use as possible completions, taking them from a 
file (-f option) or from <command>'s standard in/output.

 
* EXAMPLES:

rlwrap -r smbclient '\\PEANUT\C' 

rlwrap -f library1 -f library2 lprolog


* INSTALLATION:

Basically just

# ./configure; make install

See the INSTALL file for more information.


* PARENTHESIS MATCHING

This is not very clearly documented in readline's info or manpages, it
should be on by default. It can be controlled by putting "set
blink-matching-paren (off|on)" in your .inputrc


* AUTHOR

Hans Lub, hlub@knoware.nl

* HOMEPAGE

http://utopia.knoware.nl/~hlub/uck/rlwrap



