2001-05-18  Sebastian Wilhelmi  <wilhelmi@ira.uka.de>

	* glib/glib-overrides.txt, glib/glib-sections.txt,
	glib/tmpl/thread_pools.sgml, glib/tmpl/threads.sgml: Updated.
This commit is contained in:
Sebastian Wilhelmi 2001-05-18 08:49:29 +00:00 committed by Sebastian Wilhelmi
parent 227d18bc46
commit f2a9c8883d
5 changed files with 53 additions and 9 deletions

View File

@ -1,3 +1,8 @@
2001-05-18 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* glib/glib-overrides.txt, glib/glib-sections.txt,
glib/tmpl/thread_pools.sgml, glib/tmpl/threads.sgml: Updated.
2001-05-09 Sebastian Wilhelmi <wilhelmi@ira.uka.de> 2001-05-09 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* glib/tmpl/thread_pools.sgml, glib/tmpl/thread_pools.sgml: * glib/tmpl/thread_pools.sgml, glib/tmpl/thread_pools.sgml:

View File

@ -98,6 +98,15 @@ GStaticMutex* mutex
<RETURNS>void</RETURNS> <RETURNS>void</RETURNS>
</FUNCTION> </FUNCTION>
<FUNCTION>
<NAME>g_thread_create</NAME>
<RETURNS>GThread *</RETURNS>
GThreadFunc func
gpointer data,
gboolean joinable,
GError **error
</FUNCTION>
# G_LOCK_* macros # G_LOCK_* macros
<MACRO> <MACRO>

View File

@ -443,6 +443,7 @@ GThreadFunc
GThreadPriority GThreadPriority
GThread GThread
g_thread_create g_thread_create
g_thread_create_full
g_thread_self g_thread_self
g_thread_join g_thread_join
g_thread_set_priority g_thread_set_priority

View File

@ -68,8 +68,6 @@ this struct.
@func: the function to execute in the threads of this pool @func: the function to execute in the threads of this pool
@user_data: the user data for the threads of this pool @user_data: the user data for the threads of this pool
@bound: are the threads of this pool bound?
@priority: the priority of the threads of this pool
@exclusive: are all threads exclusive to this pool @exclusive: are all threads exclusive to this pool
<!-- ##### FUNCTION g_thread_pool_new ##### --> <!-- ##### FUNCTION g_thread_pool_new ##### -->
@ -80,14 +78,9 @@ this struct.
@func: @func:
@user_data: @user_data:
@max_threads: @max_threads:
@stack_size:
@bound:
@priority:
@exclusive: @exclusive:
@error: @error:
@Returns: @Returns:
<!-- # Unused Parameters # -->
@thread_func:
<!-- ##### FUNCTION g_thread_pool_push ##### --> <!-- ##### FUNCTION g_thread_pool_push ##### -->

View File

@ -220,7 +220,7 @@ you can however use it as if it was a function.
<!-- ##### USER_FUNCTION GThreadFunc ##### --> <!-- ##### USER_FUNCTION GThreadFunc ##### -->
<para> <para>
Specifies the type of the @func functions passed to Specifies the type of the @func functions passed to
g_thread_create(). g_thread_create() or g_thread_create_full().
</para> </para>
@data: data passed to the thread @data: data passed to the thread
@ -265,11 +265,38 @@ g_thread_join() is called for that thread.
@func: the function executing in that thread @func: the function executing in that thread
@data: the argument to the function @data: the argument to the function
@joinable: is this thread joinable? @joinable: is this thread joinable?
@bound: is this thread bound to a system thread?
@priority: the priority of the thread @priority: the priority of the thread
<!-- ##### FUNCTION g_thread_create ##### --> <!-- ##### FUNCTION g_thread_create ##### -->
<para> <para>
This function creates a new thread with the priority @priority.
</para>
<para>
If @joinable is #TRUE, you can wait for this threads termination
calling g_thread_wait(). Otherwise the thread will just disappear, when
ready.
</para>
<para>
The new thread executes the function @func with the argument
@data. If the thread was created successfully, it is returned.
</para>
<para>
@error can be NULL to ignore errors, or non-NULL to report errors. The
error is set, if and only if the function returns #NULL.
</para>
@func: a function to execute in the new thread
@data: an argument to supply to the new thread
@joinable: should this thread be joinable?
@error: return location for error.
@Returns: the new #GThread on success
<!-- ##### FUNCTION g_thread_create_full ##### -->
<para>
This function creates a new thread with the priority @priority. The This function creates a new thread with the priority @priority. The
stack gets the size @stack_size or the default value for the current stack gets the size @stack_size or the default value for the current
platform, if @stack_size is 0. platform, if @stack_size is 0.
@ -305,6 +332,15 @@ default.
</para> </para>
</note> </note>
<note>
<para>
Only use g_thread_create_full(), when you really can't use
g_thread_create() instead. g_thread_create() does not take
@stack_size, @bound and @priority as arguments, as they should only be
used for cases, where it is inevitable.
</para>
</note>
@func: a function to execute in the new thread @func: a function to execute in the new thread
@data: an argument to supply to the new thread @data: an argument to supply to the new thread
@stack_size: a stack size for the new thread @stack_size: a stack size for the new thread