Please report any problems to me (hlub@knoware.nl). If possible,
reconfigure with ./configure --enable-debug and run rlwrap with -d
option. The file /tmp/rlwrap.debug will help me find the problem.

* Installation problems:

rlwrap needs the readline library (ftp://ftp.gnu.org/gnu/readline/),
version 4.2 or newer. For .deb or .rpm users: install the readline
-devel- package!

Even though rlwrap now uses the excellent pseudo-terminal (pty)
handling code from rxvt, portable programming with ptys is something
of a black art. The configure script tries to guess how ptys have to
be handled on your system, but it may guess wrong. To quote rxvt's
configure script: "if we don't guess right then it's up to the user",
which means that you have to manually edit config.h (and save a copy
of it somewhere, as configure will create a new config.h when it runs.

Andreas Leitgeb wrote:

  "If (on Solaris) configure fails to detect your libreadline, 
  then (temporarily) move the dynamic libs libreadline.so*
  out of sight, and try again. (seems to be a problem in the
  readline-package obtained from sunfreeware.com)"

After "configure", make wil re-run configure. This is a minor
annoyance, and probably due to my poor understanding of automake. 

* Run-time problems

rlwrap cannot handle prompts that contain control characters.  Any
client that uses color and/or curses will confuse rlwrap (though you
may not notice this until your cursor almost reaches end-of-line)
This may change in future releases (but not by much, cf. the TODO file)

readline-4.3 support for multi-byte characters is slightly buggy,
revert to 4.2 or upgrade to 5.0. rlwrap itself doesn't yet handle
multi-byte characters correctly - again you may only notice this 
when the cursor almost reaches end-of-line. 

Filename completion is an ugly  hack. If you typed "impossib" and your
completion wordlist contains "impossible" you wont't see the file
"impossibility".

Christoffer Dam Bruun reported:

  "I have just installed rlwrap along with readline on Solaris 8 and
  found that rlwrap did not work properly with readline 4.3. After
  linking rlwrap with readline 4.2 it works correctly.

  What happended using readline 4.3 was that an extra prompt would be 
  written after the first letter on a line, e.g. with a sqlplus prompt:
  SQL>
  (now writing select )
  SQL> sSQL> select"

I (HL) have not been able to reproduce this, but there have been more
reports about this. Remedy (or rather: ugly kludge): configure with
--enable-homegrown-redisplay. 

Readline 5.0 has a slight bug where scrolling up through history and
then back again ends on a non-empty line (the first history line, in
fact) There is a patch for bash available that also works for
readline: copy bash30-005.patch to your readline-5.0 source directory
and do 

$  patch < bash30-005.patch 

Ignore complaints about the last hunk, as this is only for bash








 
