luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-05 00:46:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

document major caveat of g_private_set/g_private_get, i.e. not retaining

Browse Source 
Thu Jul 12 15:45:27 2007  Tim Janik  <timj@imendio.com>

        * glib/tmpl/threads.sgml: document major caveat of g_private_set/g_private_get,
        i.e. not retaining private data across g_thread_init.



svn path=/trunk/; revision=5628
This commit is contained in:
Tim Janik 2007-07-12 13:46:22 +00:00 committed by Tim Janik
parent 86fe2d770a
commit 64acb31862
2 changed files with 12 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/reference/ChangeLog
View File

@ -1,3 +1,8 @@
Thu Jul 12 15:45:27 2007 Tim Janik <timj@imendio.com>
* glib/tmpl/threads.sgml: document major caveat of g_private_set/g_private_get,
i.e. not retaining private data across g_thread_init.
Tue Jul 10 13:11:55 2007 Tim Janik <timj@imendio.com>
* glib/tmpl/types.sgml: corrected descriptions of gsize and gssize.

9
docs/reference/glib/tmpl/threads.sgml
View File

@ -1506,8 +1506,12 @@ current @private_key and thread yet, this pointer will be %NULL.
</para>
<para>
This function can be used even if g_thread_init() has not yet been
called, and, in that case, will return the value of @private_key casted to #gpointer.
This function can be used even if g_thread_init() has not yet been called, and,
in that case, will return the value of @private_key casted to #gpointer.
Note however, that private data set <emphasis>before</emphasis> g_thread_init() will
<emphasis>not</emphasis> be retained <emphasis>after</emphasis> the call. Instead, %NULL
will be returned in all threads directly after g_thread_init(), regardless of
any g_private_set() calls issued before threading system intialization.
</para>
@private_key: a #GPrivate.
@ -1523,6 +1527,7 @@ Sets the pointer keyed to @private_key for the current thread.
<para>
This function can be used even if g_thread_init() has not yet been
called, and, in that case, will set @private_key to @data casted to #GPrivate*.
See g_private_get() for resulting caveats.
</para>
@private_key: a #GPrivate.