libsoup r1255 - in trunk: . docs/reference

[danw svn gnome org]

Author: danw
Date: Fri Mar 27 16:18:30 2009
New Revision: 1255
URL: http://svn.gnome.org/viewvc/libsoup?rev=1255&view=rev

Log:
	* docs/reference/client-howto.xml: clarify that SoupSessionAsync
	is not thread-safe, and that setting a non-default GMainContext on
	a non-threadsafe object means you can only use that object from
	that GMainContext's thread.


Modified:
   trunk/ChangeLog
   trunk/docs/reference/client-howto.xml

Modified: trunk/docs/reference/client-howto.xml
==============================================================================
--- trunk/docs/reference/client-howto.xml	(original)
+++ trunk/docs/reference/client-howto.xml	Fri Mar 27 16:18:30 2009
@@ -102,7 +102,7 @@
 	<term><link linkend="SOUP-SESSION-ASYNC-CONTEXT--CAPS"><literal>SOUP_SESSION_ASYNC_CONTEXT</literal></link></term>
 	<listitem><para>
 	    A <link
-	    linkend="GMainContext"><type>GMainContext</type>type></link>
+	    linkend="GMainContext"><type>GMainContext</type></link>
 	    which the session will use for asynchronous operations.
 	    This can be set if you want to use a
 	    <type>SoupSessionAsync</type> in a thread other than the
@@ -497,6 +497,17 @@
 except from a message or session callback or signal handler.)
 </para>
 
+<para>
+All other objects (including <link
+linkend="SoupSessionAsync"><type>SoupSessionAsync</type></link>)
+should only be used from a single thread, with objects that are also
+only be used from that thread. (And in particular, if you set a
+non-default <link
+linkend="GMainContext"><type>GMainContext</type></link> on a session,
+socket, etc, then you can only use that object from the thread in
+which that <type>GMainContext</type> is running.)
+</para>
+
 </refsect2>
 
 <refsect2>