diff --git a/docs/libcurl/curl_easy_pause.3 b/docs/libcurl/curl_easy_pause.3 index 7debfd842411dae91691d3b416420f27d949a29e..402bb054693863afde51130dcbce726411fe58db 100644 --- a/docs/libcurl/curl_easy_pause.3 +++ b/docs/libcurl/curl_easy_pause.3 @@ -38,8 +38,11 @@ that returns pause signals to the library that it couldn't take care of any data at all, and that data will then be delivered again to the callback when the writing is later unpaused. -NOTE: while it may feel tempting, take care and notice that you cannot call -this function from another thread. +While it may feel tempting, take care and notice that you cannot call this +function from another thread. To unpause, you may for example call it from the +progress callback (see \fIcurl_easy_setopt(3)\fP's +\fICURLOPT_PROGRESSFUNCTION\fP), which gets called at least once per second, +even if the connection is paused. When this function is called to unpause reading, the chance is high that you will get your write callback called before this function returns.