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

Extended the comments on those functions, that are NOOPs, before

Browse Source 
2007-06-15  Sebastian Wilhelmi  <wilhelmi@google.com>

	* docs/reference/glib/tmpl/threads.sgml: Extended the comments on
	those functions, that are NOOPs, before g_thread_init() has been
	called. (#447583)

	* glib/gthread.c (g_static_mutex_free): Clarified comment to
	remind myself, tha calling g_static_mutex_free() before
	g_thread_init() is safe.


svn path=/trunk/; revision=5567
This commit is contained in:
Sebastian Wilhelmi 2007-06-15 17:03:13 +00:00 committed by Sebastian Wilhelmi
parent 49f802b83e
commit 16b4963816
3 changed files with 27 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
ChangeLog
View File

@ -1,3 +1,13 @@
2007-06-15 Sebastian Wilhelmi <wilhelmi@google.com>
* docs/reference/glib/tmpl/threads.sgml: Extended the comments on
those functions, that are NOOPs, before g_thread_init() has been
called. (#447583)
* glib/gthread.c (g_static_mutex_free): Clarified comment to
remind myself, tha calling g_static_mutex_free() before
g_thread_init() is safe.
2007-06-15 Cody Russell <bratsche@gnome.org> 2007-06-15 Cody Russell <bratsche@gnome.org>
* docs/reference/gobject/tmpl/gboxed.sgml: * docs/reference/gobject/tmpl/gboxed.sgml:

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

@ -714,8 +714,11 @@ platforms.
</para> </para>
<para> <para>
All of the <function>g_static_mutex_*</function> functions can also be All of the <function>g_static_mutex_*</function> functions apart from
used even if g_thread_init() has not yet been called. <function>g_static_mutex_get_mutex</function> can also be used even if
g_thread_init() has not yet been called. Then they do nothing, apart
from <function>g_static_mutex_trylock</function>, which does nothing
but returning %TRUE.
</para> </para>
<note> <note>
@ -911,8 +914,10 @@ the following functions.
</para> </para>
<para> <para>
All of the <function>g_static_rec_mutex_*</function> functions can All of the <function>g_static_rec_mutex_*</function> functions can be
be used even if g_thread_init() has not been called. used even if g_thread_init() has not been called. Then they do
nothing, apart from <function>g_static_rec_mutex_trylock</function>,
which does nothing but returning %TRUE.
</para> </para>
@ -969,7 +974,7 @@ functions increases the depth of @mutex and immediately returns %TRUE.
<!-- ##### FUNCTION g_static_rec_mutex_unlock ##### --> <!-- ##### FUNCTION g_static_rec_mutex_unlock ##### -->
<para> <para>
Unlocks @mutex. Another thread can will be allowed to lock @mutex only Unlocks @mutex. Another thread will be allowed to lock @mutex only
when it has been unlocked as many times as it had been locked when it has been unlocked as many times as it had been locked
before. If @mutex is completely unlocked and another thread is blocked before. If @mutex is completely unlocked and another thread is blocked
in a g_static_rec_mutex_lock() call for @mutex, it will be woken and in a g_static_rec_mutex_lock() call for @mutex, it will be woken and
@ -1094,7 +1099,9 @@ the following functions.
<para> <para>
All of the <function>g_static_rw_lock_*</function> functions can be All of the <function>g_static_rw_lock_*</function> functions can be
used even if g_thread_init() has not been called. used even if g_thread_init() has not been called. Then they do
nothing, apart from <function>g_static_rw_lock_*_trylock</function>,
which does nothing but returning %TRUE.
</para> </para>
<note> <note>

5
glib/gthread.c
View File

@ -230,7 +230,10 @@ g_static_mutex_free (GStaticMutex* mutex)
g_return_if_fail (mutex); g_return_if_fail (mutex);
/* The runtime_mutex is the first (or only) member of GStaticMutex, /* The runtime_mutex is the first (or only) member of GStaticMutex,
* see both versions (of glibconfig.h) in configure.in */ * see both versions (of glibconfig.h) in configure.in. Note, that
* this variable is NULL, if g_thread_init() hasn't been called or
* if we're using the default thread implementation and it provides
* static mutexes. */
runtime_mutex = ((GMutex**)mutex); runtime_mutex = ((GMutex**)mutex);
if (*runtime_mutex) if (*runtime_mutex)