Updated doc

This commit is contained in:
Tatsuhiro Tsujikawa 2012-05-16 23:48:27 +09:00
parent 85182254e7
commit f96c7f8720
1 changed files with 26 additions and 7 deletions

View File

@ -1618,11 +1618,13 @@ const char* spdylay_strerror(int error_code);
* in subsequent DATA frames. In this case, a method that allows * in subsequent DATA frames. In this case, a method that allows
* request message bodies * request message bodies
* (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9) must * (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9) must
* be specified with ``:method`` key in |nv| (e.g. ``POST``). If * be specified with ``:method`` key in |nv| (e.g. ``POST``). This
* |data_prd| is ``NULL``, SYN_STREAM have FLAG_FIN set. The * function does not take ownership of the |data_prd|. The function
* |stream_user_data| is data associated to the stream opened by this * copies the members of the |data_prd|. If |data_prd| is ``NULL``,
* request and can be an arbitrary pointer, which can be retrieved * SYN_STREAM have FLAG_FIN set. The |stream_user_data| is data
* later by `spdylay_session_get_stream_user_data()`. * associated to the stream opened by this request and can be an
* arbitrary pointer, which can be retrieved later by
* `spdylay_session_get_stream_user_data()`.
* *
* Since the library reorders the frames and tries to send the highest * Since the library reorders the frames and tries to send the highest
* prioritized one first and the SPDY specification requires the * prioritized one first and the SPDY specification requires the
@ -1677,8 +1679,10 @@ int spdylay_submit_request(spdylay_session *session, uint8_t pri,
* also lower-cases all names in |nv|. * also lower-cases all names in |nv|.
* *
* If |data_prd| is not ``NULL``, it provides data which will be sent * If |data_prd| is not ``NULL``, it provides data which will be sent
* in subsequent DATA frames. If |data_prd| is ``NULL``, SYN_REPLY * in subsequent DATA frames. This function does not take ownership
* will have FLAG_FIN set. * of the |data_prd|. The function copies the members of the
* |data_prd|. If |data_prd| is ``NULL``, SYN_REPLY will have
* FLAG_FIN set.
* *
* This function returns 0 if it succeeds, or one of the following * This function returns 0 if it succeeds, or one of the following
* negative error codes: * negative error codes:
@ -1715,6 +1719,9 @@ int spdylay_submit_response(spdylay_session *session,
* ``NULL``. That is, if the |nv| contains N name/value pairs, * ``NULL``. That is, if the |nv| contains N name/value pairs,
* ``nv[2*N]`` must be ``NULL``. * ``nv[2*N]`` must be ``NULL``.
* *
* This function creates copies of all name/value pairs in |nv|. It
* also lower-cases all names in |nv|.
*
* The |stream_user_data| is a pointer to an arbitrary * The |stream_user_data| is a pointer to an arbitrary
* data which is associated to the stream this frame will open. * data which is associated to the stream this frame will open.
* *
@ -1755,6 +1762,9 @@ int spdylay_submit_syn_stream(spdylay_session *session, uint8_t flags,
* ``NULL``. That is, if the |nv| contains N name/value pairs, * ``NULL``. That is, if the |nv| contains N name/value pairs,
* ``nv[2*N]`` must be ``NULL``. * ``nv[2*N]`` must be ``NULL``.
* *
* This function creates copies of all name/value pairs in |nv|. It
* also lower-cases all names in |nv|.
*
* This function returns 0 if it succeeds, or one of the following * This function returns 0 if it succeeds, or one of the following
* negative error codes: * negative error codes:
* *
@ -1784,6 +1794,9 @@ int spdylay_submit_syn_reply(spdylay_session *session, uint8_t flags,
* ``NULL``. That is, if the |nv| contains N name/value pairs, * ``NULL``. That is, if the |nv| contains N name/value pairs,
* ``nv[2*N]`` must be ``NULL``. * ``nv[2*N]`` must be ``NULL``.
* *
* This function creates copies of all name/value pairs in |nv|. It
* also lower-cases all names in |nv|.
*
* This function returns 0 if it succeeds, or one of the following * This function returns 0 if it succeeds, or one of the following
* negative error codes: * negative error codes:
* *
@ -1801,6 +1814,9 @@ int spdylay_submit_headers(spdylay_session *session, uint8_t flags,
* :enum:`SPDYLAY_DATA_FLAG_FIN`, the last DATA frame has FLAG_FIN * :enum:`SPDYLAY_DATA_FLAG_FIN`, the last DATA frame has FLAG_FIN
* set. * set.
* *
* This function does not take ownership of the |data_prd|. The
* function copies the members of the |data_prd|.
*
* This function returns 0 if it succeeds, or one of the following * This function returns 0 if it succeeds, or one of the following
* negative error codes: * negative error codes:
* *
@ -1861,6 +1877,9 @@ int spdylay_submit_goaway(spdylay_session *session, uint32_t status_code);
* is bitwise-OR of one or more values from * is bitwise-OR of one or more values from
* :type:`spdylay_settings_flag`. * :type:`spdylay_settings_flag`.
* *
* This function does not take ownership of the |iv|. This function
* copies all the elements in the |iv|.
*
* This function returns 0 if it succeeds, or one of the following * This function returns 0 if it succeeds, or one of the following
* negative error codes: * negative error codes:
* *