summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDan Winship <danw@src.gnome.org>2008-10-01 21:53:26 +0000
committerDan Winship <danw@src.gnome.org>2008-10-01 21:53:26 +0000
commit264eb7480e3a1c5762e4eb51f8273e6e438ff87b (patch)
treedfbcf59e3123dbebec3a70a42e9e89a7ab8974e8 /docs
parent91d657fb12308d51608dd3f6b6c4b3fa6b117bee (diff)
downloadlibsoup-264eb7480e3a1c5762e4eb51f8273e6e438ff87b.tar.gz
libsoup-264eb7480e3a1c5762e4eb51f8273e6e438ff87b.tar.bz2
libsoup-264eb7480e3a1c5762e4eb51f8273e6e438ff87b.zip
New type and methods for working with multipart HTTP bodies (eg,
* libsoup/soup-multipart.c: New type and methods for working with multipart HTTP bodies (eg, multipart/form-data and multipart/byte-ranges) * libsoup/soup-message-headers.c (soup_message_headers_get_ranges) (soup_message_headers_set_ranges) (soup_message_headers_set_range) (soup_message_headers_get_content_range) (soup_message_headers_set_content_range): New methods for dealing with the Range and Content-Range headers. * libsoup/soup-form.h (SOUP_FORM_MIME_TYPE_URLENCODED) (SOUP_FORM_MIME_TYPE_MULTIPART): #define these MIME types here * libsoup/soup-form.c (soup_form_decode_multipart): new utility for parsing multipart/form-data forms. (soup_form_request_new_from_multipart): new utility for constructing multipart/form-data forms * libsoup/soup-headers.c (soup_headers_parse): this is now non-static, for use by soup-multipart * libsoup/soup-message-server-io.c (get_response_headers) (handle_partial_get): if the client requested a partial GET, and the SoupServer is returning the full body, rebuild the response to include only the requested range instead * tests/forms-test.c: renamed from query-test and updated to do both application/x-www-form-urlencoded and multipart/form-data tests * tests/range-test.c: test of Range/Content-Range functionality svn path=/trunk/; revision=1176
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/libsoup-2.4-docs.sgml20
-rw-r--r--docs/reference/libsoup-2.4-sections.txt55
2 files changed, 61 insertions, 14 deletions
diff --git a/docs/reference/libsoup-2.4-docs.sgml b/docs/reference/libsoup-2.4-docs.sgml
index d4c3239f..25cd2afc 100644
--- a/docs/reference/libsoup-2.4-docs.sgml
+++ b/docs/reference/libsoup-2.4-docs.sgml
@@ -14,8 +14,7 @@
</chapter>
<chapter>
- <title>API Reference</title>
- <xi:include href="xml/soup-address.xml"/>
+ <title>Core API</title>
<xi:include href="xml/soup-auth.xml"/>
<xi:include href="xml/soup-auth-domain.xml"/>
<xi:include href="xml/soup-auth-domain-basic.xml"/>
@@ -27,18 +26,29 @@
<xi:include href="xml/soup-message-headers.xml"/>
<xi:include href="xml/soup-message-body.xml"/>
<xi:include href="xml/soup-method.xml"/>
+ <xi:include href="xml/soup-multipart.xml"/>
<xi:include href="xml/soup-server.xml"/>
<xi:include href="xml/soup-session.xml"/>
<xi:include href="xml/soup-session-async.xml"/>
<xi:include href="xml/soup-session-sync.xml"/>
- <xi:include href="xml/soup-socket.xml"/>
<xi:include href="xml/soup-status.xml"/>
<xi:include href="xml/soup-uri.xml"/>
- <xi:include href="xml/soup-value-utils.xml"/>
- <xi:include href="xml/soup-xmlrpc.xml"/>
<xi:include href="xml/soup-misc.xml"/>
</chapter>
+ <chapter>
+ <title>Web Services APIs</title>
+ <xi:include href="xml/soup-forms.xml"/>
+ <xi:include href="xml/soup-xmlrpc.xml"/>
+ <xi:include href="xml/soup-value-utils.xml"/>
+ </chapter>
+
+ <chapter>
+ <title>Low-level Networking API</title>
+ <xi:include href="xml/soup-address.xml"/>
+ <xi:include href="xml/soup-socket.xml"/>
+ </chapter>
+
<index>
<title>Index</title>
</index>
diff --git a/docs/reference/libsoup-2.4-sections.txt b/docs/reference/libsoup-2.4-sections.txt
index 43944ec8..dea6b6c6 100644
--- a/docs/reference/libsoup-2.4-sections.txt
+++ b/docs/reference/libsoup-2.4-sections.txt
@@ -113,6 +113,14 @@ soup_message_headers_set_content_type
<SUBSECTION>
soup_message_headers_get_content_disposition
soup_message_headers_set_content_disposition
+<SUBSECTION>
+SoupRange
+soup_message_headers_get_ranges
+soup_message_headers_set_ranges
+soup_message_headers_set_range
+soup_message_headers_free_ranges
+soup_message_headers_get_content_range
+soup_message_headers_set_content_range
<SUBSECTION Standard>
SOUP_TYPE_MESSAGE_HEADERS
soup_message_headers_get_type
@@ -569,18 +577,10 @@ soup_date_to_timeval
soup_date_is_past
soup_date_free
<SUBSECTION>
-soup_form_decode
-soup_form_encode
-soup_form_encode_datalist
-soup_form_encode_hash
-soup_form_encode_valist
-soup_form_request_new
-soup_form_request_new_from_datalist
-soup_form_request_new_from_hash
-<SUBSECTION>
soup_headers_parse_request
soup_headers_parse_response
soup_headers_parse_status_line
+soup_headers_parse
<SUBSECTION>
soup_header_parse_list
soup_header_parse_quality_list
@@ -610,6 +610,24 @@ soup_form_encode_urlencoded_list
</SECTION>
<SECTION>
+<FILE>soup-forms</FILE>
+<TITLE>HTML Form Support</TITLE>
+<SUBSECTION>
+SOUP_FORM_MIME_TYPE_MULTIPART
+SOUP_FORM_MIME_TYPE_URLENCODED
+soup_form_decode
+soup_form_decode_multipart
+soup_form_encode
+soup_form_encode_datalist
+soup_form_encode_hash
+soup_form_encode_valist
+soup_form_request_new
+soup_form_request_new_from_datalist
+soup_form_request_new_from_hash
+soup_form_request_new_from_multipart
+</SECTION>
+
+<SECTION>
<FILE>soup-xmlrpc</FILE>
<TITLE>XMLRPC Support</TITLE>
<SUBSECTION>
@@ -740,3 +758,22 @@ SOUP_IS_COOKIE_JAR_CLASS
SOUP_TYPE_COOKIE_JAR
soup_cookie_jar_get_type
</SECTION>
+
+<SECTION>
+<FILE>soup-multipart</FILE>
+<TITLE>SoupMultipart</TITLE>
+SoupMultipart
+soup_multipart_new
+soup_multipart_new_from_message
+soup_multipart_free
+<SUBSECTION>
+soup_multipart_get_length
+soup_multipart_get_part
+soup_multipart_append_part
+soup_multipart_append_form_string
+soup_multipart_append_form_file
+soup_multipart_to_message
+<SUBSECTION Standard>
+SOUP_TYPE_MULTIPART
+soup_multipart_get_type
+</SECTION>