Index: src/OFStream.h
==================================================================
--- src/OFStream.h
+++ src/OFStream.h
@@ -1072,10 +1072,16 @@
 - (int)fileDescriptorForWriting;
 
 #ifdef OF_HAVE_SOCKETS
 /*!
  * @brief Cancels all pending asyncronous requests on the stream.
+ *
+ * @warning You are not allowed to call this inside the handler of an
+ *	    asyncronous request, as this would cancel the asyncronous request
+ *	    that is currently being handled! To cancel all pending asyncronous
+ *	    requests after the handler has finished executing, you may schedule
+ *	    a timer for this method with a timeout of 0 from inside the handler.
  */
 - (void)cancelAsyncRequests;
 #endif
 
 /*!

Index: src/OFUDPSocket.h
==================================================================
--- src/OFUDPSocket.h
+++ src/OFUDPSocket.h
@@ -235,10 +235,16 @@
 	    length: (size_t)length
 	  receiver: (of_udp_socket_address_t*)receiver;
 
 /*!
  * @brief Cancels all pending asyncronous requests on the socket.
+ *
+ * @warning You are not allowed to call this inside the handler of an
+ *	    asyncronous request, as this would cancel the asyncronous request
+ *	    that is currently being handled! To cancel all pending asyncronous
+ *	    requests after the handler has finished executing, you may schedule
+ *	    a timer for this method with a timeout of 0 from inside the handler.
  */
 - (void)cancelAsyncRequests;
 
 /*!
  * @brief Closes the socket so that it can neither receive nor send any more