CLEANUP: h2: minimum documentation for recent API changes
Commit d4dd22d ("MINOR: h2: Let user of h2_recv() and h2_send() know xfer
has been done") changed the API without documenting the expected returned
values which appear to come out of nowhere in the code :-( Please don't
do that anymore! The description was recovered from the commit message.
diff --git a/src/mux_h2.c b/src/mux_h2.c
index a5ea6c3..de63512 100644
--- a/src/mux_h2.c
+++ b/src/mux_h2.c
@@ -2222,7 +2222,9 @@
}
-/* Attempt to read data, and subscribe if none available */
+/* Attempt to read data, and subscribe if none available.
+ * The function returns 1 if data has been received, otherwise zero.
+ */
static int h2_recv(struct h2c *h2c)
{
struct connection *conn = h2c->conn;
@@ -2263,7 +2265,9 @@
return 1;
}
-/* Try to send data if possible */
+/* Try to send data if possible.
+ * The function returns 1 if data have been sent, otherwise zero.
+ */
static int h2_send(struct h2c *h2c)
{
struct connection *conn = h2c->conn;