add/fix gtk-doc comments, make functions match prototypes, etc

	* libsoup/*.[ch]: add/fix gtk-doc comments, make functions match
	prototypes, etc

	* docs/reference/*: update, fix, etc

1 files changed, 14 insertions, 0 deletions

diff --git a/libsoup/soup-headers.c b/libsoup/soup-headers.c
index ee03aa93..552a7b66 100644
--- a/libsoup/soup-headers.c
+++ b/libsoup/soup-headers.c
@@ -175,6 +175,20 @@ soup_headers_parse_status_line (const char       *status_line,
 	return TRUE;
 }
 
+/**
+ * soup_headers_parse_response:
+ * @str: the header string (including the trailing blank line)
+ * @len: length of @str
+ * @dest: #GHashTable to store the header values in
+ * @ver: on return, will contain the HTTP version
+ * @status_code: on return, will contain the HTTP status code
+ * @status_pharse: on return, will contain the status phrase
+ *
+ * Parses the headers of an HTTP response in @str and stores the
+ * results in @ver, @status_code, @status_phrase, and @dest.
+ *
+ * Return value: success or failure.
+ **/
 gboolean
 soup_headers_parse_response (char             *str, 
 			     int               len,