-document better how to use MHD_resume_connection() with external event loop

1 files changed, 6 insertions, 0 deletions

diff --git a/doc/libmicrohttpd.texi b/doc/libmicrohttpd.texi
index 74a285c7..f3a96608 100644
--- a/doc/libmicrohttpd.texi
+++ b/doc/libmicrohttpd.texi
@@ -2238,6 +2238,12 @@ to resume a suspended connection at any time.  Calling this 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 @code{MHD_run} afterwards (before again calling
+@code{MHD_get_fdset}), 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}.