returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
returned by g_thread_join and is either the return of the topmost
thread function or the value given to g_thread_exit.
- * gthreadpool.c, tests/mainloop-test.c, test/thread-test.c:
+ * gthreadpool.c, tests/mainloop-test.c, tests/thread-test.c:
Adapted to the above change.
2001-01-06 Hans Breuer <hans@breuer.org>
+2001-05-08 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
+
+ * glib/tmpl/threads.sgml, glib/glib-overrides.txt: Updated.
+
2001-04-19 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* glib/tmpl/hash_tables.sgml, glib/tmpl/misc_utils.sgml,
<RETURNS>void</RETURNS>
</FUNCTION>
-<FUNCTION>
-<NAME>g_thread_exit</NAME>
-<RETURNS>void</RETURNS>
-</FUNCTION>
-
# G_LOCK_* macros
<MACRO>
</para>
@value: data supplied to the thread
+@Returns: the return value of the thread, which will be returned by
+g_thread_join()
<!-- ##### ENUM GThreadPriority ##### -->
@joinable: is this thread joinable?
@bound: is this thread bound to a system thread?
@priority: the priority of the thread
+@func: the function executing in that thread
+@arg: the argument to the function
<!-- ##### FUNCTION g_thread_create ##### -->
<para>
to g_thread_create, returns or g_thread_exit() is called by
@thread. All resources of @thread including the #GThread struct are
released. @thread must have been created with @joinable=#TRUE in
-g_thread_create().
+g_thread_create(). The value returned by @thread_func or given to
+g_thread_exit() by @thread is returned by this function.
</para>
@thread: a #GThread to be waited for
+@Returns: the return value of the thread
<!-- ##### FUNCTION g_thread_set_priority ##### -->
<!-- ##### FUNCTION g_thread_exit ##### -->
<para>
Exit the current thread. If another thread is waiting for that thread
-using g_thread_join(), that thread will be woken up.
+using g_thread_join() and the current thread is joinable, the waiting
+thread will be woken up and getting @retval as the return value of
+g_thread_join(). If the current thread is not joinable, @retval is
+ignored. Calling
+</para>
+
+<para>
+<informalexample>
+<programlisting>
+g_thread_join (retval);
+</programlisting>
+</informalexample>
+</para>
+
+<para>
+is equivalent to calling
+</para>
+
+<para>
+<informalexample>
+<programlisting>
+return retval;
+</programlisting>
+</informalexample>
+</para>
+
+<para>
+in the function @thread_func, as given to g_thread_create().
</para>
<note>
</para>
</note>
+@retval: the return value of this thread
<!-- ##### STRUCT GMutex ##### -->