--- AnyEvent/lib/AnyEvent/Handle.pm	2008/09/06 10:54:32	1.89
+++ AnyEvent/lib/AnyEvent/Handle.pm	2008/09/29 02:08:57	1.90
@@ -61,6 +61,14 @@
 All callbacks will be invoked with the handle object as their first
 argument.
 
+=head2 SIGPIPE is not handled by this module
+
+SIGPIPE is not handled by this module, so one of the practical
+requirements of using it is to ignore SIGPIPE (C<$SIG{PIPE} =
+'IGNORE'>). At least, this is highly recommend in a networked program: If
+you use AnyEvent::Handle in a filter program (like sort), exiting on
+SIGPIPE is probably the right thing to do.
+
 =head1 METHODS
 
 =over 4