--- AnyEvent-ReadLine-Gnu/Gnu.pm	2012/05/10 21:53:03	1.2
+++ AnyEvent-ReadLine-Gnu/Gnu.pm	2012/05/10 22:59:21	1.3
@@ -242,6 +242,33 @@
 
 =back
 
+=head1 CAVEATS
+
+There are some issues with readline that can be problematic in event-based
+programs:
+
+=over 4
+
+=item blocking I/O
+
+Readline uses blocking terminal I/O. Under most circumstances, this does
+not cause big delays, but ttys have the potential to block programs
+indefinitely (e.g. on XOFF).
+
+=item unexpected disk I/O
+
+By default, readline does filename completion on TAB, and reads it's config files.
+
+=item output intermixing
+
+After readline has been initialised, it will mangle the termios tty
+settings. This does not normally affect output very much, but should be
+taken into consideration.
+
+=back
+
+Oh, and the above list is probably not complete.
+
 =head1 AUTHOR, CONTACT, SUPPORT
 
  Marc Lehmann <schmorp@schmorp.de>