GNOME.org
 

libsoup r1201 - in trunk: . docs/reference libsoup

Author: danw
Date: Tue Nov  4 21:08:30 2008
New Revision: 1201
URL: http://svn.gnome.org/viewvc/libsoup?rev=1201&view=rev

Log:
	* libsoup/soup-address.c (soup_address_is_resolved):
	* libsoup/soup-cookie.c (soup_cookie_copy):
	* libsoup/soup-cookie-jar.c (soup_cookie_jar_class_init):
	* libsoup/soup-message-headers.c (SoupMessageHeadersType):
	* libsoup/soup-proxy-resolver.c
	(soup_proxy_resolver_get_proxy_async)
	(soup_proxy_resolver_get_proxy_sync):
	* libsoup/soup-status.c (soup_status_proxyify): misc doc fixes

	* libsoup/soup-cookie-jar-text.h: remove a "deprecated" API that
	was never actually released

	* libsoup/soup.h: include soup-proxy-resolver.h

	* docs/reference/Makefile.am (SCAN_OPTIONS): set
	--deprecated-guards correctly
	(IGNORE_HFILES): ignore some more internal files
	(GTKDOC_LIBS): link against libsoup-gnome, not libsoup

	* docs/reference/libsoup-2.4-docs.sgml:
	* docs/reference/libsoup-2.4.types:
	* docs/reference/libsoup-2.4-sections.txt: add new stuff


Modified:
   trunk/ChangeLog
   trunk/docs/reference/Makefile.am
   trunk/docs/reference/libsoup-2.4-docs.sgml
   trunk/docs/reference/libsoup-2.4-sections.txt
   trunk/docs/reference/libsoup-2.4.types
   trunk/libsoup/soup-address.c
   trunk/libsoup/soup-cookie-jar-text.h
   trunk/libsoup/soup-cookie-jar.c
   trunk/libsoup/soup-cookie.c
   trunk/libsoup/soup-message-headers.c
   trunk/libsoup/soup-proxy-resolver.c
   trunk/libsoup/soup-status.c
   trunk/libsoup/soup.h

Modified: trunk/docs/reference/Makefile.am
==============================================================================
--- trunk/docs/reference/Makefile.am	(original)
+++ trunk/docs/reference/Makefile.am	Tue Nov  4 21:08:30 2008
@@ -13,7 +13,7 @@
 DOC_SOURCE_DIR=../../libsoup
 
 # Extra options to supply to gtkdoc-scan.
-SCAN_OPTIONS=
+SCAN_OPTIONS=--deprecated-guards=LIBSOUP_DISABLE_DEPRECATED
 
 # Extra options to supply to gtkdoc-scangobj.
 SCANGOBJ_OPTIONS=--type-init-func 'g_type_init(); g_thread_init(NULL)'
@@ -35,7 +35,9 @@
 	soup-auth-basic.h soup-auth-digest.h soup-auth-ntlm.h \
 	soup-connection.h soup-connection-ntlm.h \
 	soup-dns.h soup-auth-manager.h soup-auth-manager-ntlm.h \
-	soup-message-queue.h soup-path-map.h soup-ssl.h
+	soup-message-queue.h soup-path-map.h soup-ssl.h \
+	soup-proxy-resolver-libproxy.h soup-proxy-resolver-gconf.h \
+	soup-proxy-resolver-static.h
 
 # Images to copy into HTML directory.
 HTML_IMAGES = 
@@ -55,7 +57,7 @@
 	$(XML_CFLAGS)			\
 	$(GNUTLS_CFLAGS)
 
-GTKDOC_LIBS = $(top_builddir)/libsoup/libsoup-2.4.la $(GLIB_LIBS)
+GTKDOC_LIBS = $(top_builddir)/libsoup/libsoup-gnome-2.4.la
 
 # include common portion ...
 include $(top_srcdir)/gtk-doc.make

Modified: trunk/docs/reference/libsoup-2.4-docs.sgml
==============================================================================
--- trunk/docs/reference/libsoup-2.4-docs.sgml	(original)
+++ trunk/docs/reference/libsoup-2.4-docs.sgml	Tue Nov  4 21:08:30 2008
@@ -21,12 +21,14 @@
     <xi:include href="xml/soup-auth-domain-digest.xml"/>
     <xi:include href="xml/soup-cookie.xml"/>
     <xi:include href="xml/soup-cookie-jar.xml"/>
+    <xi:include href="xml/soup-cookie-jar-text.xml"/>
     <xi:include href="xml/soup-logger.xml"/>
     <xi:include href="xml/soup-message.xml"/>
     <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-proxy-resolver.xml"/>
     <xi:include href="xml/soup-server.xml"/>
     <xi:include href="xml/soup-session.xml"/>
     <xi:include href="xml/soup-session-async.xml"/>
@@ -44,6 +46,12 @@
   </chapter>
 
   <chapter>
+    <title>GNOME integration</title>
+    <xi:include href="xml/soup-gnome-features.xml"/>
+    <xi:include href="xml/soup-cookie-jar-sqlite.xml"/>
+  </chapter>
+
+  <chapter>
     <title>Low-level Networking API</title>
     <xi:include href="xml/soup-address.xml"/>
     <xi:include href="xml/soup-socket.xml"/>

Modified: trunk/docs/reference/libsoup-2.4-sections.txt
==============================================================================
--- trunk/docs/reference/libsoup-2.4-sections.txt	(original)
+++ trunk/docs/reference/libsoup-2.4-sections.txt	Tue Nov  4 21:08:30 2008
@@ -13,6 +13,7 @@
 soup_message_get_http_version
 soup_message_get_uri
 soup_message_set_uri
+soup_message_get_address
 <SUBSECTION>
 soup_message_set_status
 soup_message_set_status_full
@@ -171,6 +172,7 @@
 SOUP_STATUS_IS_SERVER_ERROR
 SoupKnownStatusCode
 soup_status_get_phrase
+soup_status_proxify
 <SUBSECTION>
 SOUP_HTTP_ERROR
 <SUBSECTION Private>
@@ -325,12 +327,18 @@
 SoupAddressCallback
 soup_address_resolve_async
 soup_address_resolve_sync
+soup_address_is_resolved
 <SUBSECTION>
 soup_address_get_name
 soup_address_get_sockaddr
 soup_address_get_physical
 soup_address_get_port
 <SUBSECTION>
+soup_address_equal_by_name
+soup_address_hash_by_name
+soup_address_equal_by_ip
+soup_address_hash_by_ip
+<SUBSECTION>
 SOUP_ADDRESS_FAMILY
 SOUP_ADDRESS_NAME
 SOUP_ADDRESS_PHYSICAL
@@ -712,6 +720,8 @@
 SoupCookie
 soup_cookie_new
 soup_cookie_parse
+soup_cookie_copy
+soup_cookie_equal
 soup_cookie_free
 <SUBSECTION>
 soup_cookie_set_name
@@ -738,6 +748,9 @@
 soup_cookies_to_response
 soup_cookies_to_cookie_header
 soup_cookies_free
+<SUBSECTION Standard>
+SOUP_TYPE_COOKIE
+soup_cookie_get_type
 </SECTION>
 
 <SECTION>
@@ -748,6 +761,12 @@
 soup_cookie_jar_save
 soup_cookie_jar_get_cookies
 soup_cookie_jar_set_cookie
+<SUBSECTION>
+soup_cookie_jar_add_cookie
+soup_cookie_jar_delete_cookie
+soup_cookie_jar_all_cookies
+<SUBSECTION>
+SOUP_COOKIE_JAR_READ_ONLY
 <SUBSECTION Standard>
 SoupCookieJarClass
 SOUP_COOKIE_JAR
@@ -777,3 +796,66 @@
 SOUP_TYPE_MULTIPART
 soup_multipart_get_type
 </SECTION>
+
+<SECTION>
+<FILE>soup-cookie-jar-text</FILE>
+<TITLE>SoupCookieJarText</TITLE>
+SoupCookieJarText
+soup_cookie_jar_text_new
+<SUBSECTION>
+SOUP_COOKIE_JAR_TEXT_FILENAME
+<SUBSECTION Standard>
+SoupCookieJarTextClass
+SOUP_COOKIE_JAR_TEXT
+SOUP_COOKIE_JAR_TEXT_CLASS
+SOUP_COOKIE_JAR_TEXT_GET_CLASS
+SOUP_TYPE_COOKIE_JAR_TEXT
+SOUP_IS_COOKIE_JAR_TEXT
+SOUP_IS_COOKIE_JAR_TEXT_CLASS
+soup_cookie_jar_text_get_type
+</SECTION>
+
+<SECTION>
+<FILE>soup-cookie-jar-sqlite</FILE>
+<TITLE>SoupCookieJarSqlite</TITLE>
+SoupCookieJarSqlite
+soup_cookie_jar_sqlite_new
+<SUBSECTION>
+SOUP_COOKIE_JAR_SQLITE_FILENAME
+<SUBSECTION Standard>
+SoupCookieJarSqliteClass
+SOUP_COOKIE_JAR_SQLITE
+SOUP_COOKIE_JAR_SQLITE_CLASS
+SOUP_COOKIE_JAR_SQLITE_GET_CLASS
+SOUP_TYPE_COOKIE_JAR_SQLITE
+SOUP_IS_COOKIE_JAR_SQLITE
+SOUP_IS_COOKIE_JAR_SQLITE_CLASS
+soup_cookie_jar_sqlite_get_type
+</SECTION>
+
+<SECTION>
+<FILE>soup-proxy-resolver</FILE>
+<TITLE>SoupProxyResolver</TITLE>
+SoupProxyResolver
+SoupProxyResolverCallback
+soup_proxy_resolver_get_proxy_async
+soup_proxy_resolver_get_proxy_sync
+<SUBSECTION Standard>
+SoupProxyResolverInterface
+SOUP_PROXY_RESOLVER
+SOUP_PROXY_RESOLVER_CLASS
+SOUP_PROXY_RESOLVER_GET_CLASS
+SOUP_TYPE_PROXY_RESOLVER
+SOUP_IS_PROXY_RESOLVER
+SOUP_IS_PROXY_RESOLVER_CLASS
+soup_proxy_resolver_get_type
+</SECTION>
+
+<SECTION>
+<FILE>soup-gnome-features</FILE>
+SOUP_TYPE_GNOME_FEATURES_2_26
+SOUP_TYPE_PROXY_RESOLVER_GNOME
+<SUBSECTION Standard>
+soup_proxy_resolver_gnome_get_type
+soup_gnome_features_2_26_get_type
+</SECTION>

Modified: trunk/docs/reference/libsoup-2.4.types
==============================================================================
--- trunk/docs/reference/libsoup-2.4.types	(original)
+++ trunk/docs/reference/libsoup-2.4.types	Tue Nov  4 21:08:30 2008
@@ -1,4 +1,4 @@
-#include <libsoup/soup.h>
+#include <libsoup/soup-gnome.h>
 
 soup_address_get_type
 soup_auth_get_type
@@ -6,8 +6,11 @@
 soup_auth_domain_basic_get_type
 soup_auth_domain_digest_get_type
 soup_cookie_jar_get_type
+soup_cookie_jar_text_get_type
+soup_cookie_jar_sqlite_get_type
 soup_logger_get_type
 soup_message_get_type
+soup_proxy_resolver_get_type
 soup_server_get_type
 soup_session_get_type
 soup_session_sync_get_type

Modified: trunk/libsoup/soup-address.c
==============================================================================
--- trunk/libsoup/soup-address.c	(original)
+++ trunk/libsoup/soup-address.c	Tue Nov  4 21:08:30 2008
@@ -629,6 +629,14 @@
 	return status;
 }
 
+/**
+ * soup_address_is_resolved:
+ * @addr: a #SoupAddress
+ *
+ * Tests if @addr has already been resolved.
+ *
+ * Return value: %TRUE if @addr has been resolved.
+ **/
 gboolean
 soup_address_is_resolved (SoupAddress *addr)
 {

Modified: trunk/libsoup/soup-cookie-jar-text.h
==============================================================================
--- trunk/libsoup/soup-cookie-jar-text.h	(original)
+++ trunk/libsoup/soup-cookie-jar-text.h	Tue Nov  4 21:08:30 2008
@@ -31,9 +31,6 @@
 } SoupCookieJarTextClass;
 
 #define SOUP_COOKIE_JAR_TEXT_FILENAME  "filename"
-#ifndef LIBSOUP_DISABLE_DEPRECATED
-#define SOUP_COOKIE_JAR_TEXT_READ_ONLY SOUP_COOKIE_JAR_READ_ONLY
-#endif
 
 GType soup_cookie_jar_text_get_type (void);
 

Modified: trunk/libsoup/soup-cookie-jar.c
==============================================================================
--- trunk/libsoup/soup-cookie-jar.c	(original)
+++ trunk/libsoup/soup-cookie-jar.c	Tue Nov  4 21:08:30 2008
@@ -116,6 +116,20 @@
 	object_class->set_property = set_property;
 	object_class->get_property = get_property;
 
+	/**
+	 * SoupCookieJar::changed
+	 * @jar: the #SoupCookieJar
+	 * @old_cookie: the old #SoupCookie value
+	 * @new_cookie: the new #SoupCookie value
+	 *
+	 * Emitted when @jar changes. If a cookie has been added,
+	 * @new_cookie will contain the newly-added cookie and
+	 * @old_cookie will be %NULL. If a cookie has been deleted,
+	 * @old_cookie will contain the to-be-deleted cookie and
+	 * @new_cookie will be %NULL. If a cookie has been changed,
+	 * @old_cookie will contain its old value, and @new_cookie its
+	 * new value.
+	 **/
 	signals[CHANGED] =
 		g_signal_new ("changed",
 			      G_OBJECT_CLASS_TYPE (object_class),

Modified: trunk/libsoup/soup-cookie.c
==============================================================================
--- trunk/libsoup/soup-cookie.c	(original)
+++ trunk/libsoup/soup-cookie.c	Tue Nov  4 21:08:30 2008
@@ -142,6 +142,8 @@
  * @cookie: a #SoupCookie
  *
  * Copies @cookie.
+ *
+ * Return value: a copy of @cookie
  **/
 SoupCookie *
 soup_cookie_copy (SoupCookie *cookie)

Modified: trunk/libsoup/soup-message-headers.c
==============================================================================
--- trunk/libsoup/soup-message-headers.c	(original)
+++ trunk/libsoup/soup-message-headers.c	Tue Nov  4 21:08:30 2008
@@ -25,6 +25,7 @@
  * SoupMessageHeadersType:
  * @SOUP_MESSAGE_HEADERS_REQUEST: request headers
  * @SOUP_MESSAGE_HEADERS_RESPONSE: response headers
+ * @SOUP_MESSAGE_HEADERS_MULTIPART: multipart body part headers
  *
  * Value passed to soup_message_headers_new() to set certain default
  * behaviors.

Modified: trunk/libsoup/soup-proxy-resolver.c
==============================================================================
--- trunk/libsoup/soup-proxy-resolver.c	(original)
+++ trunk/libsoup/soup-proxy-resolver.c	Tue Nov  4 21:08:30 2008
@@ -34,7 +34,7 @@
 }
 
 /**
- * soup_proxy_resovler_get_proxy_async:
+ * soup_proxy_resolver_get_proxy_async:
  * @proxy_resolver: the #SoupProxyResolver
  * @msg: the #SoupMessage you want a proxy for
  * @async_context: the #GMainContext to invoke @callback in
@@ -60,7 +60,7 @@
 }
 
 /**
- * soup_proxy_resovler_get_proxy_sync:
+ * soup_proxy_resolver_get_proxy_sync:
  * @proxy_resolver: the #SoupProxyResolver
  * @msg: the #SoupMessage you want a proxy for
  * @cancellable: a #GCancellable, or %NULL

Modified: trunk/libsoup/soup-status.c
==============================================================================
--- trunk/libsoup/soup-status.c	(original)
+++ trunk/libsoup/soup-status.c	Tue Nov  4 21:08:30 2008
@@ -250,13 +250,13 @@
 
 /**
  * soup_status_proxify:
- * @status: a status code
+ * @status_code: a status code
  *
  * Turns SOUP_STATUS_CANT_RESOLVE into SOUP_STATUS_CANT_RESOLVE_PROXY
  * and SOUP_STATUS_CANT_CONNECT into SOUP_STATUS_CANT_CONNECT_PROXY.
  * Other status codes are passed through unchanged.
  *
- * Return value: the "proxified" equivalent of @status.
+ * Return value: the "proxified" equivalent of @status_code.
  **/
 guint
 soup_status_proxify (guint status_code)

Modified: trunk/libsoup/soup.h
==============================================================================
--- trunk/libsoup/soup.h	(original)
+++ trunk/libsoup/soup.h	Tue Nov  4 21:08:30 2008
@@ -27,6 +27,7 @@
 #include <libsoup/soup-method.h>
 #include <libsoup/soup-misc.h>
 #include <libsoup/soup-multipart.h>
+#include <libsoup/soup-proxy-resolver.h>
 #include <libsoup/soup-server.h>
 #include <libsoup/soup-session-async.h>
 #include <libsoup/soup-session-feature.h>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]