1Whenever you suspect a bug, if possible, please reconfigure with
2./configure --enable-debug and run rlwrap with a -d7 option. This will
3create a file /tmp/rlwrap.debug that will help you (or me) find the
4problem.
5
6Many (most) bug reports, especially the really weird ones, stem from
7"version skew" on distributions (RedHat, Debian) that have separate
8development packages (e.g. readline and readline-dev). For some reason
9it can happen that the devel package is out of sync with the main
10package, and then really strange things may happen. So: always update your
11{readline, ncurses}-devel packages before you complain to me!
12
13
14* Gotcha's
15
16If rlwrap doesn't seem to do anything, chances are that the rlwrapped
17program already does its own line editing. Using the -a (--always-readline)
18option will make rlwrap use its own line editor.
19
20If such programs do their own completion, it will be unusable under rlwrap
21
22
23* General inadequacy and weak spots
24
25
26The more sophisticated the terminal handling of rlwrapped program (the
27"client") gets, the less rlwrap will be able to maintain its
28transparency.  Of course, more sophisticated programs generally have
29less need for rlwrap.
30
31---
32
33rlwrap cannot handle prompts that contain control characters (except
34ANSI colour), though you may not notice this until your cursor almost
35reaches end-of-line
36
37
38---
39
40older QNX: If 'configure' complains "Oops! Your 'rm' program seems unable to run
41without file operands specified", export
42ACCEPT_INFERIOR_RM_PROGRAM=yes before running 'configure'
43
44---
45
46The -m option uses the system() (3) library function to call an
47external editor. I'm not quite sure how system() handles signals like
48TSTP an WINCH (and "system" is a difficult name to Google for...)
49Re-sizing the terminal may confuse the editor
50
51--
52
53The code that determines whether a cooked prompt should be overwritten
54(when it turns out to not have been a prompt) is needlessly complex
55and not quite correct (e.g. substitute prompts may be left standing
56when they should be erased).
57
58