+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
+Fri Dec 29 14:53:18 2000 Tim Janik <timj@gtk.org>
+
+ * configure.in: we can't grow _cv_ variables by using a backticked
+ expr that refers back to the variable (glib_cv_sizeof_system_thread for
+ G_THREAD_USE_PID_SURROGATE), that'd keep the variable growing every time
+ it's evaluated. quantum states, anyone?)
+
Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org>
* gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc()
#undef USE_LIBICONV
#undef SANE_MALLOC_PROTOS
+#undef GLIB_SIZEOF_SYSTEM_THREAD
if test x"$have_threads" = xposix; then
glib_save_CPPFLAGS="$CPPFLAGS"
CPPFLAGS="$CPPFLAGS $GTHREAD_COMPILE_IMPL_DEFINES"
- GLIB_SIZEOF([#include <pthread.h>],
- pthread_t,
- system_thread)
+ dnl we might grow sizeof(pthread_t) later on, so use a dummy name here
+ GLIB_SIZEOF([#include <pthread.h>], pthread_t, core_system_thread)
# This is not AC_CHECK_FUNC to also work with function
# name mangling in header files.
AC_MSG_CHECKING(for pthread_attr_setstacksize)
CPPFLAGS="$glib_save_CPPFLAGS"
AC_MSG_CHECKING(whether to use the PID niceness surrogate for thread priorities)
+ glib_system_thread_size_growth=0
AC_TRY_RUN([#include <pthread.h>
#include <sys/types.h>
#include <unistd.h>
$posix_priority_min != $posix_priority_max);
}],
[AC_MSG_RESULT(yes),
- AC_DEFINE(G_THREAD_USE_PID_SURROGATE, 1,
- [whether to use the PID niceness surrogate for thread priorities])
-
- glib_cv_sizeof_system_thread=`expr $glib_cv_sizeof_system_thread + $ac_cv_sizeof_long`],
+ AC_DEFINE(G_THREAD_USE_PID_SURROGATE, 1, [whether to use the PID niceness surrogate for thread priorities])
+ glib_system_thread_size_growth=$ac_cv_sizeof_long
+ ],
[AC_MSG_RESULT(no)])
-
+ dnl make sure both glib_cv_sizeof_system_thread and GLIB_SIZEOF_SYSTEM_THREAD are setup
+ glib_cv_sizeof_system_thread=`expr $glib_cv_sizeof_core_system_thread + $glib_system_thread_size_growth`
+ AC_DEFINE_UNQUOTED(GLIB_SIZEOF_SYSTEM_THREAD, $glib_cv_sizeof_system_thread)
else # solaris threads
- GLIB_SIZEOF([#include <thread.h>],
- thread_t,
- system_thread)
+ GLIB_SIZEOF([#include <thread.h>], thread_t, system_thread)
fi
LIBS="$glib_save_LIBS"
@Returns: the #GArray.
+<!-- ##### FUNCTION g_array_sort ##### -->
+<para>
+
+</para>
+
+@array:
+@compare_func:
+
+
+<!-- ##### FUNCTION g_array_sort_with_data ##### -->
+<para>
+
+</para>
+
+@array:
+@compare_func:
+@user_data:
+
+
<!-- ##### MACRO g_array_index ##### -->
<para>
Returns the element of a #GArray at the given index.
@Returns: the #GByteArray.
+<!-- ##### FUNCTION g_byte_array_sort ##### -->
+<para>
+
+</para>
+
+@array:
+@compare_func:
+
+
+<!-- ##### FUNCTION g_byte_array_sort_with_data ##### -->
+<para>
+
+</para>
+
+@array:
+@compare_func:
+@user_data:
+
+
<!-- ##### FUNCTION g_byte_array_set_size ##### -->
<para>
Sets the size of the #GByteArray, expanding it if necessary.
@Returns: the pointer which was removed.
+<!-- ##### FUNCTION g_ptr_array_sort ##### -->
+<para>
+
+</para>
+
+@array:
+@compare_func:
+
+
+<!-- ##### FUNCTION g_ptr_array_sort_with_data ##### -->
+<para>
+
+</para>
+
+@array:
+@compare_func:
+@user_data:
+
+
<!-- ##### FUNCTION g_ptr_array_set_size ##### -->
<para>
Sets the size of the array, expanding it if necessary.
reference count drops to 0).
@hash_key_func: a function to create a hash value from a key.
@hash_value_func: a function to create a hash value from a value.
-@key_compare_func:
-@Returns: a new #GCache.
-<!-- # Unused Parameters # -->
@key_equal_func: a function to compare two keys. It should return TRUE if
the two keys are equivalent.
+@Returns: a new #GCache.
+<!-- # Unused Parameters # -->
+@key_compare_func:
<!-- ##### FUNCTION g_cache_insert ##### -->
@func:
@prefix:
@cache:
+@strncmp_func:
<!-- ##### FUNCTION g_completion_new ##### -->
<para>
-<!-- ##### FUNCTION g_filename_to_utf8 ##### -->
+<!-- ##### FUNCTION g_iconv_open ##### -->
+<para>
+
+</para>
+
+@to_codeset:
+@from_codeset:
+@Returns:
+
+
+<!-- ##### FUNCTION g_iconv ##### -->
+<para>
+
+</para>
+
+@converter:
+@inbuf:
+@inbytes_left:
+@outbuf:
+@outbytes_left:
+@Returns:
+
+
+<!-- ##### FUNCTION g_iconv_close ##### -->
+<para>
+
+</para>
+
+@converter:
+@Returns:
+
+
+<!-- ##### FUNCTION g_locale_to_utf8 ##### -->
<para>
</para>
@opsysstring:
+@error:
@Returns:
-<!-- # Unused Parameters # -->
+
+
+<!-- ##### FUNCTION g_filename_to_utf8 ##### -->
+<para>
+
+</para>
+
+@opsysstring:
@error:
+@Returns:
<!-- ##### FUNCTION g_filename_from_utf8 ##### -->
</para>
@utf8string:
+@error:
@Returns:
-<!-- # Unused Parameters # -->
+
+
+<!-- ##### FUNCTION g_locale_from_utf8 ##### -->
+<para>
+
+</para>
+
+@utf8string:
@error:
+@Returns:
<!-- ##### ENUM GConvertError ##### -->
@G_CONVERT_ERROR_NO_CONVERSION:
@G_CONVERT_ERROR_ILLEGAL_SEQUENCE:
@G_CONVERT_ERROR_FAILED:
+@G_CONVERT_ERROR_PARTIAL_INPUT:
greater than zero if @lhs is greater than @rhs
+<!-- ##### FUNCTION g_date_get_day ##### -->
+<para>\r
+Return the day of the month; the #GDate must be valid.\r
+</para>
+
+@date: Date to extract the day of the month from
+@Returns: Day of the month
+
+
+<!-- ##### FUNCTION g_date_get_month ##### -->
+<para>\r
+Accessor for the month of the year. Date must be valid.\r
+</para>
+
+@date: Date to get the month from
+@Returns: A #GDateMonth
+
+
+<!-- ##### FUNCTION g_date_get_year ##### -->
+<para>\r
+Accessor; returns the year of a #GDate. The date must be valid.\r
+</para>
+
+@date: Date
+@Returns: Year in which the date falls
+
+
+<!-- ##### FUNCTION g_date_get_julian ##### -->
+<para>\r
+Accessor, returns the Julian day or "serial number" of the #GDate. The\r
+Julian day is simply the number of days since January 1, Year 1; i.e.,\r
+January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2,\r
+etc. Date must be valid.\r
+</para>
+
+@date: Date to extract the Julian day from
+@Returns: Julian day
+
+
+<!-- ##### FUNCTION g_date_get_weekday ##### -->
+<para>\r
+Returns the day of the week for a #GDate. The date must be valid.\r
+</para>
+
+@date: Date
+@Returns: Day of the week as a #GDateWeekday
+
+
+<!-- ##### FUNCTION g_date_get_day_of_year ##### -->
+<para>\r
+Return the day of the year, where Jan 1 is the first day of the\r
+year. Date must be valid.\r
+</para>
+
+@date: Date to extract day of year from
+@Returns: Day of the year
+
+
+<!-- ##### FUNCTION g_date_get_days_in_month ##### -->
+<para>\r
+Return the number of days in a month, taking leap years into account.\r
+</para>
+
+@month: Month
+@year: Year
+@Returns: Number of days in @month during the year @year.
+
+
<!-- ##### FUNCTION g_date_is_first_of_month ##### -->
<para>\r
Returns TRUE if the date is on the first of a month. Date must be valid.\r
@Returns: Boolean, if the year is a leap year
+<!-- ##### FUNCTION g_date_get_monday_week_of_year ##### -->
+<para>\r
+Return the week of the year, where weeks are understood to start on\r
+Monday. If the date is before the first Monday of the year, return\r
+0. Date must be valid.\r
+</para>
+
+@date: Date to use
+@Returns: Week of the year
+
+
+<!-- ##### FUNCTION g_date_get_monday_weeks_in_year ##### -->
+<para>\r
+Return the number of weeks in the year, where weeks are taken to start\r
+on Monday. Will be 52 or 53. Date must be valid. (Years always have 52\r
+7-day periods, plus 1 or 2 extra days depending on whether it's a leap\r
+year. This function is basically telling you how many Mondays are in\r
+the year, i.e. there are 53 Mondays if one of the extra days happens\r
+to be a Monday.)\r
+</para>
+
+@year: Year
+@Returns: Number of Mondays in the year
+
+
+<!-- ##### FUNCTION g_date_get_sunday_week_of_year ##### -->
+<para>\r
+Week of the year during which this date falls, if weeks are understood\r
+to being on Sunday. Date must be valid. Can return 0 if the day is\r
+before the first Sunday of the year.\r
+</para>
+
+@date: Date
+@Returns: Week number
+
+
+<!-- ##### FUNCTION g_date_get_sunday_weeks_in_year ##### -->
+<para>\r
+Return the number of weeks in the year, where weeks are taken to start\r
+on Sunday. Will be 52 or 53. Date must be valid. (Years always have 52\r
+7-day periods, plus 1 or 2 extra days depending on whether it's a leap\r
+year. This function is basically telling you how many Sundays are in\r
+the year, i.e. there are 53 Sundays if one of the extra days happens\r
+to be a Sunday.)\r
+</para>
+
+@year: Year to count weeks in
+@Returns: Number of weeks
+
+
<!-- ##### FUNCTION g_date_strftime ##### -->
<para>\r
Generate a printed representation of the date, in a locale-specific\r
@Returns:
+<!-- ##### FUNCTION g_mkstemp ##### -->
+<para>
+
+</para>
+
+@tmpl:
+@Returns:
+
+
+<!-- ##### FUNCTION g_file_open_tmp ##### -->
+<para>
+
+</para>
+
+@tmpl:
+@name_used:
+@error:
+@Returns:
+
+
-<!-- ##### FUNCTION g_date_get_day ##### -->
-<para>\r
-Return the day of the month; the #GDate must be valid.\r
-</para>
-
-@date: Date to extract the day of the month from
-@Returns: Day of the month
-
-<!-- ##### FUNCTION g_markup_parse_context_parse ##### -->
-<para>
-
-</para>
-
-@context:
-@text:
-@text_len:
-@error:
-@Returns:
-
-<!-- ##### STRUCT GSource ##### -->
-<para>
-
-</para>
-
-
<!-- ##### FUNCTION g_source_connect_indirect ##### -->
<para>
@callback_data:
@callback_funcs:
-<!-- ##### FUNCTION g_date_get_sunday_weeks_in_year ##### -->
-<para>\r
-Return the number of weeks in the year, where weeks are taken to start\r
-on Sunday. Will be 52 or 53. Date must be valid. (Years always have 52\r
-7-day periods, plus 1 or 2 extra days depending on whether it's a leap\r
-year. This function is basically telling you how many Sundays are in\r
-the year, i.e. there are 53 Sundays if one of the extra days happens\r
-to be a Sunday.)\r
-</para>
-
-@year: Year to count weeks in
-@Returns: Number of weeks
-
-<!-- ##### FUNCTION g_locale_to_utf8 ##### -->
-<para>
-
-</para>
-
-@opsysstring:
-@error:
-@Returns:
-
-<!-- ##### FUNCTION g_iconv_close ##### -->
-<para>
-
-</para>
-
-@converter:
-@Returns:
-
<!-- ##### MACRO popen ##### -->
<para>
</para>
-<!-- ##### FUNCTION g_source_set_can_recurse ##### -->
-<para>
-
-</para>
-
-@source:
-@can_recurse:
-
-<!-- ##### FUNCTION g_date_get_days_in_month ##### -->
-<para>\r
-Return the number of days in a month, taking leap years into account.\r
-</para>
-
-@month: Month
-@year: Year
-@Returns: Number of days in @month during the year @year.
-
-<!-- ##### FUNCTION g_date_get_julian ##### -->
-<para>\r
-Accessor, returns the Julian day or "serial number" of the #GDate. The\r
-Julian day is simply the number of days since January 1, Year 1; i.e.,\r
-January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2,\r
-etc. Date must be valid.\r
-</para>
-
-@date: Date to extract the Julian day from
-@Returns: Julian day
-
<!-- ##### MACRO pclose ##### -->
<para>
See #G_PRIORITY_DEFAULT, #G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH,
#G_PRIORITY_HIGH_IDLE, and #G_PRIORITY_LOW.
-<!-- ##### ENUM GMarkupError ##### -->
-<para>
-
-</para>
-
-@G_MARKUP_ERROR_BAD_UTF8: text being parsed was not valid UTF-8
-@G_MARKUP_ERROR_EMPTY: document contained nothing, or only whitespace
-@G_MARKUP_ERROR_PARSE: document was ill-formed
-@G_MARKUP_ERROR_UNKNOWN_ELEMENT: error should be set by #GMarkupParser functions; element wasn't known
-@G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE: error should be set by #GMarkupParser functions; attribute wasn't known
-@G_MARKUP_ERROR_INVALID_CONTENT: error should be set by #GMarkupParser functions; something was wrong with contents of the document, e.g. invalid attribute value
-
-<!-- ##### FUNCTION g_main_context_add_poll ##### -->
-<para>
-
-</para>
-
-@context:
-@fd:
-@priority:
-
<!-- ##### MACRO lseek ##### -->
<para>
</para>
-<!-- ##### FUNCTION g_string_new_len ##### -->
-<para>
-
-</para>
-
-@init:
-@len:
-@Returns:
-
-<!-- ##### STRUCT GSourceCallbackFuncs ##### -->
-<para>
-
-</para>
-
-@ref:
-@unref:
-@get:
-
-<!-- ##### FUNCTION g_array_sort ##### -->
-<para>
-
-</para>
-
-@array:
-@compare_func:
-
-<!-- ##### FUNCTION g_main_context_find_source_by_funcs_user_data ##### -->
-<para>
-
-</para>
-
-@context:
-@funcs:
-@user_data:
-@Returns:
-@source_data:
-
-<!-- ##### FUNCTION g_markup_parse_context_free ##### -->
-<para>
-
-</para>
-
-@context:
-
-<!-- ##### STRUCT GMarkupParseContext ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION g_ptr_array_sort ##### -->
-<para>
-
-</para>
-
-@array:
-@compare_func:
-
-<!-- ##### FUNCTION g_main_context_query ##### -->
-<para>
-
-</para>
-
-@context:
-@max_priority:
-@timeout:
-@fds:
-@n_fds:
-@Returns:
-
-<!-- ##### FUNCTION g_iconv_open ##### -->
-<para>
-
-</para>
-
-@to_codeset:
-@from_codeset:
-@Returns:
-
-<!-- ##### FUNCTION g_source_new ##### -->
-<para>
-
-</para>
-
-@source_funcs:
-@struct_size:
-@Returns:
-
-<!-- ##### FUNCTION g_date_get_monday_week_of_year ##### -->
-<para>\r
-Return the week of the year, where weeks are understood to start on\r
-Monday. If the date is before the first Monday of the year, return\r
-0. Date must be valid.\r
-</para>
-
-@date: Date to use
-@Returns: Week of the year
-
<!-- ##### MACRO getpid ##### -->
<para>
</para>
-<!-- ##### FUNCTION g_source_get_id ##### -->
+<!-- ##### FUNCTION g_source_add ##### -->
<para>
-
-</para>
-
-@source:
-@Returns:
-
-<!-- ##### FUNCTION g_date_get_year ##### -->
-<para>\r
-Accessor; returns the year of a #GDate. The date must be valid.\r
</para>
-@date: Date
-@Returns: Year in which the date falls
-
-<!-- ##### FUNCTION g_mkstemp ##### -->
-<para>
-
-</para>
-
-@tmpl:
-@Returns:
-
-<!-- ##### FUNCTION g_date_get_month ##### -->
-<para>\r
-Accessor for the month of the year. Date must be valid.\r
-</para>
-
-@date: Date to get the month from
-@Returns: A #GDateMonth
-
-<!-- ##### FUNCTION g_main_context_get_poll_func ##### -->
-<para>
-
-</para>
-
-@context:
+@priority:
+@can_recurse:
+@funcs:
+@source_data:
+@user_data:
+@notify:
@Returns:
-
-<!-- ##### FUNCTION g_source_add_poll ##### -->
-<para>
-
-</para>
-
@source:
-@fd:
+@context:
<!-- ##### MACRO fdopen ##### -->
<para>
@s2:
@Returns:
-<!-- ##### FUNCTION g_source_get_current_time ##### -->
-<para>
-
-</para>
-
-@source:
-@timeval:
-
-<!-- ##### FUNCTION g_main_loop_new ##### -->
-<para>
-
-</para>
-
-@context:
-@is_running:
-@Returns:
-
-<!-- ##### FUNCTION g_iconv ##### -->
-<para>
-
-</para>
-
-@converter:
-@inbuf:
-@inbytes_left:
-@outbuf:
-@outbytes_left:
-@Returns:
-
-<!-- ##### FUNCTION g_source_ref ##### -->
-<para>
-
-</para>
-
-@source:
-@Returns:
-
-<!-- ##### FUNCTION g_byte_array_sort ##### -->
-<para>
-
-</para>
-
-@array:
-@compare_func:
-
-<!-- ##### MACRO G_MODULE_SUFFIX ##### -->
-<para>
-Expands to the proper shared library suffix for the current platform
-without the leading dot. For the most Unices and Linux this is "so",
-for some HPUX versions this is "sl" and for Windows this is "dll".
-</para>
-
-
-<!-- ##### FUNCTION g_markup_parse_context_get_position ##### -->
-<para>
-
-</para>
-
-@context:
-@line_number:
-@char_number:
-
-<!-- ##### FUNCTION g_locale_from_utf8 ##### -->
-<para>
-
-</para>
-
-@utf8string:
-@error:
-@Returns:
-
-<!-- ##### FUNCTION g_main_loop_is_running ##### -->
-<para>
-
-</para>
-
-@loop:
-@Returns:
-
-<!-- ##### FUNCTION g_main_context_remove_poll ##### -->
-<para>
-
-</para>
-
-@context:
-@fd:
-
-<!-- ##### FUNCTION g_byte_array_sort_with_data ##### -->
-<para>
-
-</para>
-
-@array:
-@compare_func:
-@user_data:
-
-<!-- ##### FUNCTION g_markup_parse_context_new ##### -->
-<para>
-
-</para>
-
-@parser:
-@flags:
-@user_data:
-@user_data_dnotify:
-@Returns:
-
-<!-- ##### FUNCTION g_source_get_can_recurse ##### -->
-<para>
-
-</para>
-
-@source:
-@Returns:
-
-<!-- ##### FUNCTION g_main_context_get ##### -->
-<para>
-
-</para>
-
-@thread:
-@Returns:
-
-<!-- ##### FUNCTION g_source_remove_poll ##### -->
-<para>
-
-</para>
-
-@source:
-@fd:
-
-<!-- ##### FUNCTION g_date_get_day_of_year ##### -->
-<para>\r
-Return the day of the year, where Jan 1 is the first day of the\r
-year. Date must be valid.\r
-</para>
-
-@date: Date to extract day of year from
-@Returns: Day of the year
-
-<!-- ##### FUNCTION g_tree_new_with_data ##### -->
-<para>
-
-</para>
-
-@key_compare_func:
-@user_data:
-@Returns:
-
-<!-- ##### FUNCTION g_source_get_priority ##### -->
-<para>
-
-</para>
-
-@source:
-@Returns:
-
<!-- ##### FUNCTION g_source_connect ##### -->
<para>
@data:
@notify:
-<!-- ##### FUNCTION g_main_context_iteration ##### -->
-<para>
-
-</para>
-
-@context:
-@may_block:
-@Returns:
-
-<!-- ##### FUNCTION g_main_context_dispatch ##### -->
-<para>
-
-</para>
-
-@context:
-
-<!-- ##### FUNCTION g_main_loop_quit ##### -->
-<para>
-
-</para>
-
-@loop:
-
-<!-- ##### FUNCTION g_main_context_prepare ##### -->
-<para>
-
-</para>
-
-@context:
-@priority:
-@Returns:
-
-<!-- ##### FUNCTION g_date_get_sunday_week_of_year ##### -->
-<para>\r
-Week of the year during which this date falls, if weeks are understood\r
-to being on Sunday. Date must be valid. Can return 0 if the day is\r
-before the first Sunday of the year.\r
-</para>
-
-@date: Date
-@Returns: Week number
-
-<!-- ##### FUNCTION g_source_set_priority ##### -->
-<para>
-
-</para>
-
-@source:
-@priority:
-
-<!-- ##### FUNCTION g_ptr_array_sort_with_data ##### -->
-<para>
-
-</para>
-
-@array:
-@compare_func:
-@user_data:
-
-<!-- ##### FUNCTION g_list_sort_with_data ##### -->
-<para>
-
-</para>
-
-@list:
-@compare_func:
-@user_data:
-@Returns:
-
-<!-- ##### FUNCTION g_date_get_monday_weeks_in_year ##### -->
-<para>\r
-Return the number of weeks in the year, where weeks are taken to start\r
-on Monday. Will be 52 or 53. Date must be valid. (Years always have 52\r
-7-day periods, plus 1 or 2 extra days depending on whether it's a leap\r
-year. This function is basically telling you how many Mondays are in\r
-the year, i.e. there are 53 Mondays if one of the extra days happens\r
-to be a Monday.)\r
-</para>
-
-@year: Year
-@Returns: Number of Mondays in the year
-
-<!-- ##### FUNCTION g_main_context_find_source_by_user_data ##### -->
-<para>
-
-</para>
-
-@context:
-@user_data:
-@Returns:
-
-<!-- ##### FUNCTION g_main_context_set_poll_func ##### -->
-<para>
-
-</para>
-
-@context:
-@func:
-
<!-- ##### MACRO getcwd ##### -->
<para>
</para>
-<!-- ##### MACRO g_rand_boolean ##### -->
-<para>
-Return a random #gboolean from @rand. This corresponds to a unbiased
-coin toss.
-</para>
-
-@rand: a #GRand.
-@Returns: a random #gboolean.
-
-<!-- ##### FUNCTION g_io_create_watch ##### -->
-<para>
-
-</para>
-
-@channel:
-@condition:
-@Returns:
-
-<!-- ##### FUNCTION g_source_unref ##### -->
-<para>
-
-</para>
-
-@source:
-
<!-- ##### MACRO write ##### -->
<para>
</para>
-<!-- ##### FUNCTION g_main_context_find_source_by_id ##### -->
-<para>
-
-</para>
-
-@context:
-@id:
-@Returns:
-
<!-- ##### FUNCTION g_main_remove_poll ##### -->
<para>
Removes a file descriptor from the list being polled.
</para>
-<!-- ##### FUNCTION g_idle_source_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
<!-- ##### MACRO g_string ##### -->
<para>
Turns the argument into a string literal by using the '#' stringizing operator.
@x: text to convert to a literal string.
-<!-- ##### FUNCTION g_main_context_pending ##### -->
-<para>
-
-</para>
-
-@context:
-@Returns:
-
<!-- ##### FUNCTION g_main_win32_get_poll_func ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION g_main_loop_run ##### -->
-<para>
-
-</para>
-
-@loop:
-
-<!-- ##### FUNCTION g_date_get_weekday ##### -->
-<para>\r
-Returns the day of the week for a #GDate. The date must be valid.\r
-</para>
-
-@date: Date
-@Returns: Day of the week as a #GDateWeekday
-
<!-- ##### MACRO read ##### -->
<para>
</para>
-<!-- ##### FUNCTION g_array_sort_with_data ##### -->
-<para>
-
-</para>
-
-@array:
-@compare_func:
-@user_data:
-
-<!-- ##### MACRO G_MARKUP_ERROR ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION g_main_context_default ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### ENUM GMarkupParseFlags ##### -->
-<para>
-There are no flags right now
-</para>
-
-@G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG:
-
-<!-- ##### MACRO g_random_boolean ##### -->
-<para>
-Return a random #gboolean. This corresponds to a unbiased coin toss.
-</para>
-
-@Returns: a random #gboolean.
-
-<!-- ##### FUNCTION g_slist_sort_with_data ##### -->
-<para>
-
-</para>
-
-@list:
-@compare_func:
-@user_data:
-@Returns:
-
-<!-- ##### FUNCTION g_markup_parse_context_end_parse ##### -->
-<para>
-
-</para>
-
-@context:
-@error:
-@Returns:
-
-<!-- ##### FUNCTION g_source_get_context ##### -->
-<para>
-
-</para>
-
-@source:
-@Returns:
-
-<!-- ##### FUNCTION g_timeout_source_new ##### -->
-<para>
-
-</para>
-
-@interval:
-@Returns:
-
-<!-- ##### STRUCT GMarkupParser ##### -->
-<para>
-Any of the fields in #GMarkupParser can be %NULL, in which case they
-will be ignored. Except for the @error function, any of these
-callbacks can set an error; in particular the
-%G_MARKUP_ERROR_UNKNOWN_ELEMENT, %G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE,
-and %G_MARKUP_ERROR_INVALID_CONTENT errors are intended to be set
-from these callbacks. If you set an error from a callback,
-g_markup_parse_context_parse() will report that error back to its caller.
-</para>
-
-@start_element: Callback to invoke when the opening tag of an element
-is seen.
-@end_element: Callback to invoke when the closing tag of an element is seen
-@text: Callback to invoke when some text is seen (text is always
-inside an element)
-@passthrough: Callback to invoke for comments and processing
-instructions; if you're re-writing the parsed document, write the
-passthrough text back out in the same position
-@error: Callback to invoke when an error occurs
-
-<!-- ##### USER_FUNCTION GEqualFunc ##### -->
-<para>
-Specifies the type of a function used to test two values for
-equality. The function should return TRUE if both values are equal and
-FALSE otherwise.
-</para>
-
-@a: a value.
-@b: a value to compare with.
-@Returns: TRUE if @a = @b; FALSE otherwise.
-
-<!-- ##### FUNCTION g_main_loop_destroy ##### -->
-<para>
-
-</para>
-
-@loop:
-
-<!-- ##### FUNCTION g_file_open_tmp ##### -->
-<para>
-
-</para>
-
-@tmpl:
-@name_used:
-@error:
-@Returns:
-
-<!-- ##### STRUCT GMainContext ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION g_main_context_check ##### -->
-<para>
-
-</para>
-
-@context:
-@max_priority:
-@fds:
-@n_fds:
-@Returns:
-
<!-- ##### FUNCTION g_convert_error_quark ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION g_source_destroy ##### -->
-<para>
-
-</para>
-
-@source:
-
-<!-- ##### FUNCTION g_markup_escape_text ##### -->
-<para>
-
-</para>
-
-@text:
-@length:
-@Returns:
-
<!-- ##### MACRO open ##### -->
<para>
#GHashTable data structure.
The g_direct_hash(), g_int_hash() and g_str_hash() functions are provided for
some common types of keys. If hash_func is NULL, g_direct_hash() is used.
-@key_compare_func:
-@Returns: a new #GHashTable.
-<!-- # Unused Parameters # -->
@key_equal_func: a function to check two keys for equality. This is
used when looking up keys in the #GHashTable. The g_direct_equal(),
g_int_equal() and g_str_equal() functions are provided for the most
common types of keys. If @key_equal_func is NULL, keys are compared
directly in a similar fashion to g_direct_equal(), but without the
overhead of a function call.
+@Returns: a new #GHashTable.
+<!-- # Unused Parameters # -->
+@key_compare_func:
<!-- ##### USER_FUNCTION GHashFunc ##### -->
@Returns: the hash value corresponding to the key.
+<!-- ##### USER_FUNCTION GEqualFunc ##### -->
+<para>
+Specifies the type of a function used to test two values for
+equality. The function should return TRUE if both values are equal and
+FALSE otherwise.
+</para>
+
+@a: a value.
+@b: a value to compare with.
+@Returns: TRUE if @a = @b; FALSE otherwise.
+
+
<!-- ##### FUNCTION g_hash_table_insert ##### -->
<para>
Inserts a new key and value into a #GHashTable.
@hash_table: a #GHashTable.
@key: the key to remove.
+@Returns:
<!-- ##### FUNCTION g_hash_table_foreach_remove ##### -->
@channel: a #GIOChannel.
+<!-- ##### FUNCTION g_io_create_watch ##### -->
+<para>
+
+</para>
+
+@channel:
+@condition:
+@Returns:
+
+
<!-- ##### FUNCTION g_io_add_watch ##### -->
<para>
Adds the #GIOChannel into the
@io_write:
@io_seek:
@io_close:
-@io_add_watch:
+@io_create_watch:
@io_free:
@Returns: the start of the sorted #GList.
+<!-- ##### FUNCTION g_list_sort_with_data ##### -->
+<para>
+
+</para>
+
+@list:
+@compare_func:
+@user_data:
+@Returns:
+
+
<!-- ##### USER_FUNCTION GCompareFunc ##### -->
<para>
Specifies the type of a comparison function used to compare two
@Returns: the start of the sorted #GList.
+<!-- ##### FUNCTION g_slist_sort_with_data ##### -->
+<para>
+
+</para>
+
+@list:
+@compare_func:
+@user_data:
+@Returns:
+
+
<!-- ##### FUNCTION g_slist_concat ##### -->
<para>
Adds the second #GSList onto the end of the first #GSList.
</para>
-<!-- ##### FUNCTION g_main_new ##### -->
+<!-- ##### FUNCTION g_main_loop_new ##### -->
+<para>
+
+</para>
+
+@context:
+@is_running:
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_loop_destroy ##### -->
+<para>
+
+</para>
+
+@loop:
+
+
+<!-- ##### FUNCTION g_main_loop_run ##### -->
+<para>
+
+</para>
+
+@loop:
+
+
+<!-- ##### FUNCTION g_main_loop_quit ##### -->
+<para>
+
+</para>
+
+@loop:
+
+
+<!-- ##### FUNCTION g_main_loop_is_running ##### -->
+<para>
+
+</para>
+
+@loop:
+@Returns:
+
+
+<!-- ##### MACRO g_main_new ##### -->
<para>
Creates a new #GMainLoop for the default main loop. A compatibility
macro, see g_main_loop_new().
@Returns: a new #GMainLoop.
-<!-- ##### FUNCTION g_main_destroy ##### -->
+<!-- ##### MACRO g_main_destroy ##### -->
<para>
Frees the memory allocated for the #GMainLoop. A compatibility macro, see
g_main_loop_destroy().
@loop: a #GMainLoop.
-<!-- ##### FUNCTION g_main_run ##### -->
+<!-- ##### MACRO g_main_run ##### -->
<para>
Runs a main loop until it stops running. A compatibility macro, see g_main_loop_run().
</para>
@loop: a #GMainLoop.
-<!-- ##### FUNCTION g_main_quit ##### -->
+<!-- ##### MACRO g_main_quit ##### -->
<para>
Stops the #GMainLoop. If g_main_run() was called to run the #GMainLoop,
it will now return. A compatibility macro, see g_main_loop_quit().
@loop: a #GMainLoop.
-<!-- ##### FUNCTION g_main_is_running ##### -->
+<!-- ##### MACRO g_main_is_running ##### -->
<para>
Checks if the main loop is running. A compatibility macro, see
g_main_loop_is_running().
-<!-- ##### FUNCTION g_main_iteration ##### -->
+<!-- ##### STRUCT GMainContext ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION g_main_context_get ##### -->
+<para>
+
+</para>
+
+@thread:
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_context_default ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_context_iteration ##### -->
+<para>
+
+</para>
+
+@context:
+@may_block:
+@Returns:
+
+
+<!-- ##### MACRO g_main_iteration ##### -->
<para>
Runs a single iteration for the default #GMainContext.
A compatibility macro, see g_main_context_iteration().
@Returns: TRUE if more events are pending.
-<!-- ##### FUNCTION g_main_pending ##### -->
+<!-- ##### FUNCTION g_main_context_pending ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### MACRO g_main_pending ##### -->
<para>
Checks if any events are pending for the default #GMainContext
(i.e. ready to be processed). A compatibility macro, see
@Returns: %TRUE if any events are pending.
+<!-- ##### FUNCTION g_main_context_find_source_by_id ##### -->
+<para>
+
+</para>
+
+@context:
+@id:
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_context_find_source_by_user_data ##### -->
+<para>
+
+</para>
+
+@context:
+@user_data:
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_context_find_source_by_funcs_user_data ##### -->
+<para>
+
+</para>
+
+@context:
+@funcs:
+@user_data:
+@Returns:
+<!-- # Unused Parameters # -->
+@source_data:
+
+
+<!-- ##### FUNCTION g_main_context_prepare ##### -->
+<para>
+
+</para>
+
+@context:
+@priority:
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_context_query ##### -->
+<para>
+
+</para>
+
+@context:
+@max_priority:
+@timeout:
+@fds:
+@n_fds:
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_context_check ##### -->
+<para>
+
+</para>
+
+@context:
+@max_priority:
+@fds:
+@n_fds:
+@Returns:
+
+
+<!-- ##### FUNCTION g_main_context_dispatch ##### -->
+<para>
+
+</para>
+
+@context:
+
+
+<!-- ##### FUNCTION g_main_context_set_poll_func ##### -->
+<para>
+
+</para>
+
+@context:
+@func:
+
+
+<!-- ##### FUNCTION g_main_context_get_poll_func ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
<!-- ##### USER_FUNCTION GPollFunc ##### -->
<para>
Specifies the type of function passed to g_main_set_poll_func().
or -1 if an error occurred.
-<!-- ##### FUNCTION g_main_set_poll_func ##### -->
+<!-- ##### FUNCTION g_main_context_add_poll ##### -->
+<para>
+
+</para>
+
+@context:
+@fd:
+@priority:
+
+
+<!-- ##### FUNCTION g_main_context_remove_poll ##### -->
+<para>
+
+</para>
+
+@context:
+@fd:
+
+
+<!-- ##### MACRO g_main_set_poll_func ##### -->
<para>
Sets the function to use for the handle polling of file descriptors
for the default main context. This is a compatability macro, see
@func: the function to call to poll all file descriptors.
+<!-- ##### FUNCTION g_timeout_source_new ##### -->
+<para>
+
+</para>
+
+@interval:
+@Returns:
+
+
<!-- ##### FUNCTION g_timeout_add ##### -->
<para>
</para>
@Returns:
+<!-- ##### FUNCTION g_idle_source_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
<!-- ##### FUNCTION g_idle_add ##### -->
<para>
</para>
@priority:
@function:
@data:
-@destroy:
+@notify:
@Returns:
<!-- # Unused Parameters # -->
-@notify:
+@destroy:
<!-- ##### FUNCTION g_idle_remove_by_data ##### -->
@events:
@revents:
+<!-- ##### STRUCT GSource ##### -->
+<para>
+
+</para>
+
+
<!-- ##### STRUCT GSourceFuncs ##### -->
<para>
The #GSourceFuncs struct contains a table of functions used to handle
@dispatch:
@destroy:
-<!-- ##### FUNCTION g_source_add ##### -->
+<!-- ##### STRUCT GSourceCallbackFuncs ##### -->
+<para>
+
+</para>
+
+@ref:
+@unref:
+@get:
+
+<!-- ##### FUNCTION g_source_new ##### -->
+<para>
+
+</para>
+
+@source_funcs:
+@struct_size:
+@Returns:
+
+
+<!-- ##### FUNCTION g_source_ref ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### FUNCTION g_source_unref ##### -->
+<para>
+
+</para>
+
+@source:
+
+
+<!-- ##### FUNCTION g_source_destroy ##### -->
<para>
+
</para>
+@source:
+
+
+<!-- ##### FUNCTION g_source_set_priority ##### -->
+<para>
+
+</para>
+
+@source:
@priority:
+
+
+<!-- ##### FUNCTION g_source_get_priority ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### FUNCTION g_source_set_can_recurse ##### -->
+<para>
+
+</para>
+
+@source:
@can_recurse:
-@funcs:
-@source_data:
-@user_data:
-@notify:
+
+
+<!-- ##### FUNCTION g_source_get_can_recurse ##### -->
+<para>
+
+</para>
+
+@source:
@Returns:
-<!-- # Unused Parameters # -->
+
+
+<!-- ##### FUNCTION g_source_get_id ##### -->
+<para>
+
+</para>
+
@source:
-@context:
+@Returns:
+
+
+<!-- ##### FUNCTION g_source_get_context ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
<!-- ##### USER_FUNCTION GSourceFunc ##### -->
@Returns: it should return FALSE if the source should be removed.
+<!-- ##### FUNCTION g_source_add_poll ##### -->
+<para>
+
+</para>
+
+@source:
+@fd:
+
+
+<!-- ##### FUNCTION g_source_remove_poll ##### -->
+<para>
+
+</para>
+
+@source:
+@fd:
+
+
+<!-- ##### FUNCTION g_source_get_current_time ##### -->
+<para>
+
+</para>
+
+@source:
+@timeval:
+
+
<!-- ##### FUNCTION g_source_remove ##### -->
<para>
</para>
</para>
+<!-- ##### ENUM GMarkupError ##### -->
+<para>
+
+</para>
+
+@G_MARKUP_ERROR_BAD_UTF8: text being parsed was not valid UTF-8
+@G_MARKUP_ERROR_EMPTY: document contained nothing, or only whitespace
+@G_MARKUP_ERROR_PARSE: document was ill-formed
+@G_MARKUP_ERROR_UNKNOWN_ELEMENT: error should be set by #GMarkupParser functions; element wasn't known
+@G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE: error should be set by #GMarkupParser functions; attribute wasn't known
+@G_MARKUP_ERROR_INVALID_CONTENT: error should be set by #GMarkupParser functions; something was wrong with contents of the document, e.g. invalid attribute value
+
+<!-- ##### MACRO G_MARKUP_ERROR ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### ENUM GMarkupParseFlags ##### -->
+<para>
+There are no flags right now
+</para>
+
+@G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG:
+
+<!-- ##### STRUCT GMarkupParseContext ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT GMarkupParser ##### -->
+<para>
+Any of the fields in #GMarkupParser can be %NULL, in which case they
+will be ignored. Except for the @error function, any of these
+callbacks can set an error; in particular the
+%G_MARKUP_ERROR_UNKNOWN_ELEMENT, %G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE,
+and %G_MARKUP_ERROR_INVALID_CONTENT errors are intended to be set
+from these callbacks. If you set an error from a callback,
+g_markup_parse_context_parse() will report that error back to its caller.
+</para>
+
+@start_element: Callback to invoke when the opening tag of an element
+is seen.
+@end_element: Callback to invoke when the closing tag of an element is seen
+@text: Callback to invoke when some text is seen (text is always
+inside an element)
+@passthrough: Callback to invoke for comments and processing
+instructions; if you're re-writing the parsed document, write the
+passthrough text back out in the same position
+@error: Callback to invoke when an error occurs
+
+<!-- ##### FUNCTION g_markup_escape_text ##### -->
+<para>
+
+</para>
+
+@text:
+@length:
+@Returns:
+
+
+<!-- ##### FUNCTION g_markup_parse_context_end_parse ##### -->
+<para>
+
+</para>
+
+@context:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_markup_parse_context_free ##### -->
+<para>
+
+</para>
+
+@context:
+
+
+<!-- ##### FUNCTION g_markup_parse_context_get_position ##### -->
+<para>
+
+</para>
+
+@context:
+@line_number:
+@char_number:
+
+
+<!-- ##### FUNCTION g_markup_parse_context_new ##### -->
+<para>
+
+</para>
+
+@parser:
+@flags:
+@user_data:
+@user_data_dnotify:
+@Returns:
+
+
+<!-- ##### FUNCTION g_markup_parse_context_parse ##### -->
+<para>
+
+</para>
+
+@context:
+@text:
+@text_len:
+@error:
+@Returns:
+
+
If @count is 0 it returns NULL.
</para>
+@struct_type:
+@n_structs:
+@Returns: a pointer to the allocated memory, cast to a pointer to @type.
+<!-- # Unused Parameters # -->
@type: the type of the elements to allocate.
@count: the number of elements to allocate.
-@Returns: a pointer to the allocated memory, cast to a pointer to @type.
<!-- ##### MACRO g_new0 ##### -->
If @count is 0 it returns NULL.
</para>
+@struct_type:
+@n_structs:
+@Returns: a pointer to the allocated memory, cast to a pointer to @type.
+<!-- # Unused Parameters # -->
@type: the type of the elements to allocate.
@count: the number of elements to allocate.
-@Returns: a pointer to the allocated memory, cast to a pointer to @type.
<!-- ##### MACRO g_renew ##### -->
which may have been moved.
</para>
-@type: the type of the elements to allocate.
+@struct_type:
@mem: the currently allocated memory.
-@count: the number of elements to allocate.
+@n_structs:
@Returns: a pointer to the new allocated memory, cast to a pointer to @type.
+<!-- # Unused Parameters # -->
+@type: the type of the elements to allocate.
+@count: the number of elements to allocate.
<!-- ##### FUNCTION g_malloc ##### -->
If @size is 0 it returns NULL.
</para>
-@size: the number of bytes to allocate.
+@n_bytes:
@Returns: a pointer to the allocated memory.
+<!-- # Unused Parameters # -->
+@size: the number of bytes to allocate.
<!-- ##### FUNCTION g_malloc0 ##### -->
If @size is 0 it returns NULL.
</para>
-@size: the number of bytes to allocate.
+@n_bytes:
@Returns: a pointer to the allocated memory.
+<!-- # Unused Parameters # -->
+@size: the number of bytes to allocate.
<!-- ##### FUNCTION g_realloc ##### -->
</para>
@mem: the memory to reallocate.
-@size: the new size of the allocated memory, in bytes.
+@n_bytes:
@Returns: the new address of the allocated memory.
+<!-- # Unused Parameters # -->
+@size: the new size of the allocated memory, in bytes.
<!-- ##### FUNCTION g_free ##### -->
@module: the module about to be unloaded.
+<!-- ##### MACRO G_MODULE_SUFFIX ##### -->
+<para>
+Expands to the proper shared library suffix for the current platform
+without the leading dot. For the most Unices and Linux this is "so",
+for some HPUX versions this is "sl" and for Windows this is "dll".
+</para>
+
+
+
<!-- ##### MACRO G_MODULE_EXPORT ##### -->
<para>
Used to declare functions exported by modules.
@seed:
+<!-- ##### MACRO g_rand_boolean ##### -->
+<para>
+Return a random #gboolean from @rand. This corresponds to a unbiased
+coin toss.
+</para>
+
+@rand: a #GRand.
+@Returns: a random #gboolean.
+
+
<!-- ##### FUNCTION g_rand_int ##### -->
@rand:
-@min:
-@max:
-@Returns:
-<!-- # Unused Parameters # -->
@begin:
@end:
+@Returns:
+<!-- # Unused Parameters # -->
+@min:
+@max:
<!-- ##### FUNCTION g_rand_double ##### -->
@rand:
-@min:
-@max:
-@Returns:
-<!-- # Unused Parameters # -->
@begin:
@end:
+@Returns:
+<!-- # Unused Parameters # -->
+@min:
+@max:
<!-- ##### FUNCTION g_random_set_seed ##### -->
@seed:
+<!-- ##### MACRO g_random_boolean ##### -->
+<para>
+Return a random #gboolean. This corresponds to a unbiased coin toss.
+</para>
+
+@Returns: a random #gboolean.
+
+
<!-- ##### FUNCTION g_random_int ##### -->
<!-- ##### FUNCTION g_random_int_range ##### -->
-@min:
-@max:
-@Returns:
-<!-- # Unused Parameters # -->
@begin:
@end:
+@Returns:
+<!-- # Unused Parameters # -->
+@min:
+@max:
<!-- ##### FUNCTION g_random_double ##### -->
<!-- ##### FUNCTION g_random_double_range ##### -->
-@min:
-@max:
-@Returns:
-<!-- # Unused Parameters # -->
@begin:
@end:
+@Returns:
+<!-- # Unused Parameters # -->
+@min:
+@max:
@relation: a #GRelation.
@field: the field to index, counting from 0.
@hash_func: a function to produce a hash value from the field data.
-@key_compare_func:
-<!-- # Unused Parameters # -->
@key_equal_func: a function to compare two values of the given field.
+<!-- # Unused Parameters # -->
+@key_compare_func:
<!-- ##### FUNCTION g_relation_insert ##### -->
</para>
@command_line:
-@argc:
-@argv:
+@argcp:
+@argvp:
@error:
@Returns:
<!-- # Unused Parameters # -->
-@argcp:
-@argvp:
+@argc:
+@argv:
<!-- ##### FUNCTION g_shell_quote ##### -->
@Returns: the new #GString.
+<!-- ##### FUNCTION g_string_new_len ##### -->
+<para>
+
+</para>
+
+@init:
+@len:
+@Returns:
+
+
<!-- ##### FUNCTION g_string_sized_new ##### -->
<para>
Creates a new GString, with enough space for @dfl_size characters.
@Returns: a new #GTree.
+<!-- ##### FUNCTION g_tree_new_with_data ##### -->
+<para>
+
+</para>
+
+@key_compare_func:
+@user_data:
+@Returns:
+
+
<!-- ##### FUNCTION g_tree_insert ##### -->
<para>
Inserts a key/value pair into a #GTree.
-<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Long_Description ##### -->
+<!-- ##### FUNCTION g_type_conforms_to ##### -->
<para>
</para>
+@type:
+@iface_type:
+@Returns:
-<!-- ##### USER_FUNCTION GTypePluginUnRef ##### -->
+<!-- ##### FUNCTION g_object_class_install_param ##### -->
<para>
</para>
-@plugin:
+@oclass:
+@param_id:
+@pspec:
-<!-- ##### FUNCTION g_signals_destroy ##### -->
+<!-- ##### FUNCTION g_param_spec_hash_table_insert ##### -->
<para>
</para>
-@itype:
+@hash_table:
+@pspec:
+@owner_type:
-<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Short_Description ##### -->
+<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:See_Also ##### -->
+<para>
+</para>
-<!-- ##### STRUCT GTypePluginVTable ##### -->
+<!-- ##### MACRO G_IS_PARAM_VALUE ##### -->
<para>
</para>
-@plugin_ref:
-@plugin_unref:
-@complete_type_info:
-@complete_interface_info:
+@pspec:
+@value:
-<!-- ##### FUNCTION g_signal_connect_closure ##### -->
+<!-- ##### FUNCTION g_type_instance_conforms_to ##### -->
<para>
</para>
@instance:
-@signal_id:
-@detail:
-@closure:
-@after:
+@iface_type:
@Returns:
+<!-- ##### FUNCTION g_object_get_param ##### -->
+<para>
+
+</para>
+
+@object:
+@param_name:
+@value:
+
+<!-- ##### USER_FUNCTION GTypePluginRef ##### -->
+<para>
+
+</para>
+
+@plugin:
+
+<!-- ##### FUNCTION g_object_set_param ##### -->
+<para>
+
+</para>
+
+@object:
+@param_name:
+@value:
+
+<!-- ##### USER_FUNCTION GObjectGetParamFunc ##### -->
+<para>
+
+</para>
+
+@object:
+@param_id:
+@value:
+@pspec:
+@trailer:
+
<!-- ##### ENUM GSignalType ##### -->
<para>
@G_SIGNAL_ACTION:
@G_SIGNAL_NO_HOOKS:
-<!-- ##### USER_FUNCTION GTypePluginFillTypeInfo ##### -->
+<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@plugin:
-@g_type:
-@info:
-@value_table:
-<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:See_Also ##### -->
+<!-- ##### FUNCTION g_signal_type_closure_new ##### -->
<para>
</para>
+@itype:
+@struct_offset:
+@Returns:
-<!-- ##### USER_FUNCTION GTypePluginRef ##### -->
+<!-- ##### FUNCTION g_object_class_find_param_spec ##### -->
+<para>
+
+</para>
+
+@oclass:
+@param_name:
+@Returns:
+
+<!-- ##### FUNCTION g_object_queue_param_changed ##### -->
+<para>
+
+</para>
+
+@object:
+@param_name:
+
+<!-- ##### FUNCTION g_signal_connect_closure ##### -->
+<para>
+
+</para>
+
+@instance:
+@signal_id:
+@detail:
+@closure:
+@after:
+@Returns:
+
+<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Title ##### -->
+gtypemodule.sgml
+
+
+<!-- ##### USER_FUNCTION GTypePluginUnRef ##### -->
<para>
</para>
@plugin:
+<!-- ##### FUNCTION g_param_spec_hash_table_lookup ##### -->
+<para>
+
+</para>
+
+@hash_table:
+@param_name:
+@owner_type:
+@try_ancestors:
+@trailer:
+@Returns:
+
+<!-- ##### USER_FUNCTION GObjectSetParamFunc ##### -->
+<para>
+
+</para>
+
+@object:
+@param_id:
+@value:
+@pspec:
+@trailer:
+
+<!-- ##### FUNCTION g_type_value_conforms_to ##### -->
+<para>
+
+</para>
+
+@value:
+@type:
+@Returns:
+
<!-- ##### FUNCTION g_signal_handlers_destroy ##### -->
<para>
@flags:
@Returns:
-<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Title ##### -->
-gtypemodule.sgml
+<!-- ##### USER_FUNCTION GTypePluginFillTypeInfo ##### -->
+<para>
+
+</para>
+@plugin:
+@g_type:
+@info:
+@value_table:
+
+<!-- ##### FUNCTION g_signals_destroy ##### -->
+<para>
+
+</para>
+
+@itype:
+
+<!-- ##### STRUCT GTypePluginVTable ##### -->
+<para>
+
+</para>
+
+@plugin_ref:
+@plugin_unref:
+@complete_type_info:
+@complete_interface_info:
<!-- ##### USER_FUNCTION GTypePluginFillInterfaceInfo ##### -->
<para>
@instance_type:
@info:
+<!-- ##### MACRO G_NOTIFY_PRIORITY ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO G_WARN_INVALID_PARAM_ID ##### -->
+<para>
+
+</para>
+
+@object:
+@param_id:
+@pspec:
+
+<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### FUNCTION g_param_spec_hash_table_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION g_param_spec_hash_table_remove ##### -->
+<para>
+
+</para>
+
+@hash_table:
+@pspec:
+
@class:
-<!-- ##### MACRO G_NOTIFY_PRIORITY ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### USER_FUNCTION GObjectGetParamFunc ##### -->
-<para>
-
-</para>
-
-@object:
-@param_id:
-@value:
-@pspec:
-@trailer:
-
-
-<!-- ##### USER_FUNCTION GObjectSetParamFunc ##### -->
-<para>
-
-</para>
-
-@object:
-@param_id:
-@value:
-@pspec:
-@trailer:
-
-
<!-- ##### USER_FUNCTION GObjectFinalizeFunc ##### -->
<para>
@object:
-<!-- ##### FUNCTION g_object_class_install_param ##### -->
-<para>
-
-</para>
-
-@oclass:
-@param_id:
-@pspec:
-
-
-<!-- ##### FUNCTION g_object_class_find_param_spec ##### -->
-<para>
-
-</para>
-
-@oclass:
-@param_name:
-@Returns:
-
-
<!-- ##### FUNCTION g_object_new ##### -->
<para>
</para>
@object_type:
-@first_param_name:
+@first_property_name:
@Varargs:
@Returns:
+<!-- # Unused Parameters # -->
+@first_param_name:
<!-- ##### FUNCTION g_object_new_valist ##### -->
</para>
@object_type:
-@first_param_name:
+@first_property_name:
@var_args:
@Returns:
+<!-- # Unused Parameters # -->
+@first_param_name:
<!-- ##### FUNCTION g_object_set ##### -->
</para>
@object:
-@first_param_name:
+@first_property_name:
@Varargs:
+<!-- # Unused Parameters # -->
+@first_param_name:
<!-- ##### FUNCTION g_object_get ##### -->
</para>
@object:
-@first_param_name:
+@first_property_name:
@Varargs:
+<!-- # Unused Parameters # -->
+@first_param_name:
<!-- ##### FUNCTION g_object_set_valist ##### -->
</para>
@object:
-@first_param_name:
+@first_property_name:
@var_args:
+<!-- # Unused Parameters # -->
+@first_param_name:
<!-- ##### FUNCTION g_object_get_valist ##### -->
</para>
@object:
-@first_param_name:
+@first_property_name:
@var_args:
-
-
-<!-- ##### FUNCTION g_object_set_param ##### -->
-<para>
-
-</para>
-
-@object:
-@param_name:
-@value:
-
-
-<!-- ##### FUNCTION g_object_get_param ##### -->
-<para>
-
-</para>
-
-@object:
-@param_name:
-@value:
-
-
-<!-- ##### FUNCTION g_object_queue_param_changed ##### -->
-<para>
-
-</para>
-
-@object:
-@param_name:
+<!-- # Unused Parameters # -->
+@first_param_name:
<!-- ##### FUNCTION g_object_ref ##### -->
@Returns:
-<!-- ##### MACRO G_WARN_INVALID_PARAM_ID ##### -->
-<para>
-
-</para>
-
-@object:
-@param_id:
-@pspec:
-
-
</para>
-@g_instance:
+@g_type_instance:
@name:
@nick:
@blurb:
@flags:
+@value_type:
<!-- ##### STRUCT GParamSpecClass ##### -->
<para>
@pspec:
-<!-- ##### MACRO G_IS_PARAM_VALUE ##### -->
-<para>
-
-</para>
-
-@pspec:
-@value:
-
-
<!-- ##### MACRO G_PARAM_SPEC_VALUE_TYPE ##### -->
<para>
@G_PARAM_READABLE:
@G_PARAM_WRITABLE:
-@G_PARAM_MASK:
-@G_PARAM_USER_MASK:
+@G_PARAM_CONSTRUCT:
+@G_PARAM_CONSTRUCT_ONLY:
+@G_PARAM_PRIVATE:
<!-- ##### FUNCTION g_param_spec_ref ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION g_param_spec_hash_table_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-
-<!-- ##### FUNCTION g_param_spec_hash_table_insert ##### -->
-<para>
-
-</para>
-
-@hash_table:
-@pspec:
-@owner_type:
-
-
-<!-- ##### FUNCTION g_param_spec_hash_table_remove ##### -->
-<para>
-
-</para>
-
-@hash_table:
-@pspec:
-
-
-<!-- ##### FUNCTION g_param_spec_hash_table_lookup ##### -->
-<para>
-
-</para>
-
-@hash_table:
-@param_name:
-@owner_type:
-@try_ancestors:
-@trailer:
-@Returns:
-
-
@detail:
-<!-- ##### FUNCTION g_signal_type_closure_new ##### -->
-<para>
-
-</para>
-
-@itype:
-@struct_offset:
-@Returns:
-
-
<!-- ##### FUNCTION g_signal_add_emission_hook_full ##### -->
<para>
</para>
@parent_instance:
-@object_type:
<!-- ##### FUNCTION g_param_spec_char ##### -->
<para>
@G_TYPE_PARAM:
@G_TYPE_BOXED:
@G_TYPE_POINTER:
+@G_TYPE_CCALLBACK:
@G_TYPE_OBJECT:
@G_TYPE_GTK_SIGNAL:
@G_TYPE_BSE_PROCEDURE:
@G_TYPE_PARAM_FLOAT:
@G_TYPE_PARAM_DOUBLE:
@G_TYPE_PARAM_STRING:
+@G_TYPE_PARAM_PARAM:
+@G_TYPE_PARAM_POINTER:
+@G_TYPE_PARAM_CCALLBACK:
+@G_TYPE_PARAM_BOXED:
@G_TYPE_PARAM_OBJECT:
<!-- ##### MACRO G_TYPE_IS_CLASSED ##### -->
@Returns:
-<!-- ##### FUNCTION g_type_conforms_to ##### -->
-<para>
-
-</para>
-
-@type:
-@iface_type:
-@Returns:
-
-
<!-- ##### FUNCTION g_type_fundamental_branch_last ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION g_type_instance_conforms_to ##### -->
-<para>
-
-</para>
-
-@instance:
-@iface_type:
-@Returns:
-
-
<!-- ##### FUNCTION g_type_check_flags ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION g_type_value_conforms_to ##### -->
-<para>
-
-</para>
-
-@value:
-@type:
-@Returns:
-
-