mention that error events need to be handled in all classes

mojolicious · Oct 29, 2013 · a7a0779 · a7a0779
1 parent 892e9c9
commit a7a0779
Show file tree

Hide file tree

Showing 5 changed files with 9 additions and 6 deletions.
diff --git a/lib/Mojo/IOLoop/Client.pm b/lib/Mojo/IOLoop/Client.pm
@@ -174,7 +174,7 @@ Emitted safely once the connection is established.
     ...
   });
 
-Emitted if an error occurs on the connection.
+Emitted if an error occurs on the connection, fatal if unhandled.
 
 =head1 ATTRIBUTES
 

diff --git a/lib/Mojo/IOLoop/Delay.pm b/lib/Mojo/IOLoop/Delay.pm
@@ -115,7 +115,8 @@ emit the following new ones.
     ...
   });
 
-Emitted if an error occurs in one of the steps, breaking the chain.
+Emitted if an error occurs in one of the steps, breaking the chain, fatal if
+unhandled.
 
 =head2 finish
 

diff --git a/lib/Mojo/IOLoop/Stream.pm b/lib/Mojo/IOLoop/Stream.pm
@@ -204,7 +204,7 @@ Emitted safely once all data has been written.
     ...
   });
 
-Emitted if an error occurs on the stream.
+Emitted if an error occurs on the stream, fatal if unhandled.
 
 =head2 read
 

diff --git a/lib/Mojo/Reactor.pm b/lib/Mojo/Reactor.pm
@@ -77,8 +77,9 @@ the following new ones.
     ...
   });
 
-Emitted for exceptions caught in callbacks. Note that if this event is
-unhandled or fails it might kill your program, so you need to be careful.
+Emitted for exceptions caught in callbacks, fatal if unhandled. Note that if
+this event is unhandled or fails it might kill your program, so you need to be
+careful.
 
   $reactor->on(error => sub {
     my ($reactor, $err) = @_;

diff --git a/lib/Mojo/UserAgent.pm b/lib/Mojo/UserAgent.pm
@@ -564,7 +564,8 @@ the following new ones.
     ...
   });
 
-Emitted if an error occurs that can't be associated with a transaction.
+Emitted if an error occurs that can't be associated with a transaction, fatal
+if unhandled.
 
   $ua->on(error => sub {
     my ($ua, $err) = @_;