improve documentation for key-value iterator

3 files changed, 20 insertions, 0 deletions

diff --git a/doc/libmicrohttpd.texi b/doc/libmicrohttpd.texi
index 52c8e19d..f229b033 100644
--- a/doc/libmicrohttpd.texi
+++ b/doc/libmicrohttpd.texi
@@ -1123,6 +1123,21 @@ over all of the cookies, headers, or @code{POST}-data fields of a
 request, and also to iterate over the headers that have been added to a
 response.
 
+@table @var
+@item cls
+custom value specified when iteration was triggered;
+
+@item kind
+kind of the header we are looking at
+
+@item key
+key for the value, can be an empty string
+
+@item value
+value corresponding value, can be NULL
+
+@end table
+
 Return @code{MHD_YES} to continue iterating, @code{MHD_NO} to abort the
 iteration.
 @end deftypefn
diff --git a/src/include/microhttpd.h b/src/include/microhttpd.h
index b5d6b054..46346097 100644
--- a/src/include/microhttpd.h
+++ b/src/include/microhttpd.h
@@ -1218,6 +1218,10 @@ typedef void
  * also to iterate over the headers that have been
  * added to a response.
  *
+ * @param cls closure
+ * @param kind kind of the header we are looking at
+ * @param key key for the value, can be an empty string
+ * @param value corresponding value, can be NULL
  * @return #MHD_YES to continue iterating,
  *         #MHD_NO to abort the iteration
  * @ingroup request
diff --git a/src/microhttpd/daemon.c b/src/microhttpd/daemon.c
index a65aca8f..55bd363c 100644
--- a/src/microhttpd/daemon.c
+++ b/src/microhttpd/daemon.c
@@ -1589,6 +1589,7 @@ MHD_resume_connection (struct MHD_Connection *connection)
     MHD_PANIC ("Failed to release cleanup mutex\n");
 }
 
+
 /**
  * Run through the suspended connections and move any that are no
  * longer suspended back to the active state.