@@ -40,10 +40,17 @@
 #ifdef OF_HAVE_OPTIONAL_PROTOCOLS
 @optional
 #endif
 /**
  * \brief This callback is called when a stream did get ready for reading.
+ *
+ * NOTE: When -[tryReadLine] or -[tryReadTillDelimiter:] has been called on the
+ *	 the stream, this callback will not be called again until new data has
+ *	 been received, even though there is still data in the cache. The reason
+ *	 for this is to prevent spinning in a loop when there is an incomplete
+ *	 string in the cache. Once the string is complete, the callback will be
+ *	 called again if there is data in the cache.
  *
  * \param stream The stream which did become ready for reading
  */
 - (void)streamIsReadyForReading: (OFStream*)stream;