Clarify AbstractContentDecoder Javadoc
Especially readFromChannel and fillBufferFromChannel
diff --git a/httpcore5/src/main/java/org/apache/hc/core5/http/impl/nio/AbstractContentDecoder.java b/httpcore5/src/main/java/org/apache/hc/core5/http/impl/nio/AbstractContentDecoder.java
index ff25a1a..0795228 100644
--- a/httpcore5/src/main/java/org/apache/hc/core5/http/impl/nio/AbstractContentDecoder.java
+++ b/httpcore5/src/main/java/org/apache/hc/core5/http/impl/nio/AbstractContentDecoder.java
@@ -122,6 +122,7 @@
*
* @param dst destination.
* @return number of bytes transferred.
+ * @throws IOException If an I/O error occurs.
*
* @since 4.3
*/
@@ -135,7 +136,9 @@
/**
* Reads from the channel to the session buffer.
- * @return number of bytes transferred.
+ *
+ * @return number of bytes transferred, possibly zero, or {@code -1} if the channel has reached end-of-stream.
+ * @throws IOException If an I/O error occurs.
*
* @since 4.3
*/
@@ -152,7 +155,8 @@
*
* @param dst destination.
* @param limit max number of bytes to transfer.
- * @return number of bytes transferred.
+ * @return number of bytes transferred, possibly zero, or {@code -1} if the channel has reached end-of-stream.
+ * @throws IOException If an I/O error occurs.
*
* @since 4.3
*/