libsoup r1208 - in branches/gnome-2-24: . libsoup

[danw svn gnome org]

Author: danw
Date: Mon Nov 24 17:17:50 2008
New Revision: 1208
URL: http://svn.gnome.org/viewvc/libsoup?rev=1208&view=rev

Log:
another pullup (SoupLogger docs)


Modified:
   branches/gnome-2-24/   (props changed)
   branches/gnome-2-24/ChangeLog
   branches/gnome-2-24/libsoup/soup-logger.c

Modified: branches/gnome-2-24/libsoup/soup-logger.c
==============================================================================
--- branches/gnome-2-24/libsoup/soup-logger.c	(original)
+++ branches/gnome-2-24/libsoup/soup-logger.c	Mon Nov 24 17:17:50 2008
@@ -66,6 +66,17 @@
  * across the lifetime of the #SoupLogger. In particular, this can be
  * used to identify when multiple messages are sent across the same
  * connection.
+ *
+ * The request half of the message is logged just before the first
+ * byte of the request gets written to the network (from the
+ * #SoupSession::request_started signal), and the response is logged
+ * just after the last byte of the response body is read from the
+ * network (from the #SoupMessage::got_body or
+ * #SoupMessage::got_informational signal). In particular, note that
+ * the #SoupMessage::got_headers signal, and anything triggered off it
+ * (such as #SoupSession::authenticate) will be emitted
+ * <emphasis>before</emphasis> the response headers are actually
+ * logged.
  **/
 
 static void soup_logger_session_feature_init (SoupSessionFeatureInterface *feature_interface, gpointer interface_data);