@@ -245,11 +245,13 @@
  *
  * On network streams, this might read less than the specified number of bytes.
  * If you want to read exactly the specified number of bytes, use
  * @ref readIntoBuffer:exactLength:. Note that a read can even return 0 bytes -
  * this does not necessarily mean that the stream ended, so you still need to
- * check @ref atEndOfStream.
+ * check @ref atEndOfStream. Do not assume that the stream ended just because a
+ * read returned 0 bytes - some streams do internal processing that has a
+ * result of 0 bytes.
  *
  * @param buffer The buffer into which the data is read
  * @param length The length of the data that should be read at most.
  *		 The buffer *must* be *at least* this big!
  * @return The number of bytes read
@@ -282,11 +284,13 @@
  *
  * On network streams, this might read less than the specified number of bytes.
  * If you want to read exactly the specified number of bytes, use
  * @ref asyncReadIntoBuffer:exactLength:. Note that a read can even return 0
  * bytes - this does not necessarily mean that the stream ended, so you still
- * need to check @ref atEndOfStream.
+ * need to check @ref atEndOfStream. Do not assume that the stream ended just
+ * because a read returned 0 bytes - some streams do internal processing that
+ * has a result of 0 bytes.
  *
  * @note The stream must conform to @ref OFReadyForReadingObserving in order
  *	 for this to work!
  *
  * @param buffer The buffer into which the data is read.
@@ -303,11 +307,13 @@
  *
  * On network streams, this might read less than the specified number of bytes.
  * If you want to read exactly the specified number of bytes, use
  * @ref asyncReadIntoBuffer:exactLength:. Note that a read can even return 0
  * bytes - this does not necessarily mean that the stream ended, so you still
- * need to check @ref atEndOfStream.
+ * need to check @ref atEndOfStream. Do not assume that the stream ended just
+ * because a read returned 0 bytes - some streams do internal processing that
+ * has a result of 0 bytes.
  *
  * @note The stream must conform to @ref OFReadyForReadingObserving in order
  *	 for this to work!
  *
  * @param buffer The buffer into which the data is read.
@@ -367,11 +373,13 @@
  *
  * On network streams, this might read less than the specified number of bytes.
  * If you want to read exactly the specified number of bytes, use
  * @ref asyncReadIntoBuffer:exactLength:block:. Note that a read can even
  * return 0 bytes - this does not necessarily mean that the stream ended, so
- * you still need to check @ref atEndOfStream.
+ * you still need to check @ref atEndOfStream. Do not assume that the stream
+ * ended just because a read returned 0 bytes - some streams do internal
+ * processing that has a result of 0 bytes.
  *
  * @note The stream must conform to @ref OFReadyForReadingObserving in order
  *	 for this to work!
  *
  * @param buffer The buffer into which the data is read.
@@ -394,11 +402,13 @@
  *
  * On network streams, this might read less than the specified number of bytes.
  * If you want to read exactly the specified number of bytes, use
  * @ref asyncReadIntoBuffer:exactLength:block:. Note that a read can even
  * return 0 bytes - this does not necessarily mean that the stream ended, so
- * you still need to check @ref atEndOfStream.
+ * you still need to check @ref atEndOfStream. Do not assume that the stream
+ * ended just because a read returned 0 bytes - some streams do internal
+ * processing that has a result of 0 bytes.
  *
  * @note The stream must conform to @ref OFReadyForReadingObserving in order
  *	 for this to work!
  *
  * @param buffer The buffer into which the data is read.