Merge pull request #1488 from tomaskrizek/doc-session-send-flow-control

doc: clarify flow control behaviour for nghttp2_session_send()

lib/includes/nghttp2/nghttp2.h

@@ -2853,7 +2853,8 @@ NGHTTP2_EXTERN void nghttp2_session_del(nghttp2_session *session);
  * outbound queue and sends it to the remote peer.  It does this as
  * many as possible until the user callback
  * :type:`nghttp2_send_callback` returns
- * :enum:`NGHTTP2_ERR_WOULDBLOCK` or the outbound queue becomes empty.
+ * :enum:`NGHTTP2_ERR_WOULDBLOCK`, the outbound queue becomes empty
+ * or remote window size becomes depleted due to flow control.
  * This function calls several callback functions which are passed
  * when initializing the |session|.  Here is the simple time chart
  * which tells when each callback is invoked: