[GNUnet-SVN] r37877 - in libmicrohttpd: doc src/include

[gnunet]

Author: grothoff
Date: 2016-09-04 17:51:15 +0200 (Sun, 04 Sep 2016)
New Revision: 37877

Modified:
   libmicrohttpd/doc/libmicrohttpd.texi
   libmicrohttpd/src/include/microhttpd.h
Log:
-document better how to use MHD_resume_connection() with external event loop

Modified: libmicrohttpd/doc/libmicrohttpd.texi
===================================================================
--- libmicrohttpd/doc/libmicrohttpd.texi        2016-09-04 15:46:02 UTC (rev 
37876)
+++ libmicrohttpd/doc/libmicrohttpd.texi        2016-09-04 15:51:15 UTC (rev 
37877)
@@ -2238,6 +2238,12 @@
 on a connection that was not previously suspended will result in
 undefined behavior.
 
+If you are using this function in ``external'' select mode, you must
+make sure to run @code{MHD_run} afterwards (before again calling
address@hidden), as otherwise the change may not be reflected in
+the set returned by @code{MHD_get_fdset} and you may end up with a
+connection that is stuck until the next network activity.
+
 You can check whether a connection is currently suspended using
 @code{MHD_get_connection_info} by querying for
 @code{MHD_CONNECTION_INFO_CONNECTION_SUSPENDED}.

Modified: libmicrohttpd/src/include/microhttpd.h
===================================================================
--- libmicrohttpd/src/include/microhttpd.h      2016-09-04 15:46:02 UTC (rev 
37876)
+++ libmicrohttpd/src/include/microhttpd.h      2016-09-04 15:51:15 UTC (rev 
37877)
@@ -1998,6 +1998,12 @@
  * function on a connection that was not previously suspended will
  * result in undefined behavior.
  *
+ * If you are using this function in ``external'' select mode, you must
+ * make sure to run #MHD_run() afterwards (before again calling
+ * #MHD_get_fdset(), as otherwise the change may not be reflected in
+ * the set returned by #MHD_get_fdset() and you may end up with a
+ * connection that is stuck until the next network activity.
+ *
  * @param connection the connection to resume
  */
 _MHD_EXTERN void