@@ -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