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