Index: src/OFStream.h
==================================================================
--- src/OFStream.h
+++ src/OFStream.h
@@ -49,11 +49,15 @@
  * \return A boolean whether the end of the stream has been reached
  */
 - (BOOL)isAtEndOfStream;
 
 /**
- * Reads at most size bytes from the stream into a buffer.
+ * \brief Reads <i>at most</i> size bytes from the stream into a buffer.
+ *
+ * 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
+ * -[readExactlyNBytes:intoBuffer:].
  *
  * \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