+2005-06-29 Matthias Clasen <mclasen@redhat.com>
+
+ * glib/tmpl/threads.sgml:
+ * glib/tmpl/option.sgml:
+ * glib/tmpl/fileutils.sgml:
+ * glib/tmpl/iochannels.sgml:
+ * glib/tmpl/hooks.sgml:
+ * glib/tmpl/misc_utils.sgml:
+ * glib/tmpl/date.sgml:
+ * glib/glib-sections.txt: Updates
+
2005-06-24 Matthias Clasen <mclasen@redhat.com>
* glib/glib-sections.txt: Add GMappedFile functions.
g_mkstemp
g_file_open_tmp
g_file_read_link
+g_mkdir_with_parents
<SUBSECTION>
GDir
g_get_system_config_dirs
<SUBSECTION>
+g_get_host_name
g_get_home_dir
g_get_tmp_dir
g_get_current_dir
month, and year.
</para>
-@julian_days:
-@julian:
-@dmy:
-@day:
-@month:
-@year:
+@julian_days: the Julian representation of the date
+@julian: this bit is set if @julian_days is valid
+@dmy: this is set if @day, @month and @year are valid
+@day: the day of the day-month-year representation of the date, as
+ a number between 1 and 31
+@month: the day of the day-month-year representation of the date, as
+ a number between 1 and 12
+@year: the day of the day-month-year representation of the date
<!-- ##### TYPEDEF GTime ##### -->
<para>
to mark a number as a day, month, or year.
</para>
-@G_DATE_DAY:
-@G_DATE_MONTH:
-@G_DATE_YEAR:
+@G_DATE_DAY: a day
+@G_DATE_MONTH: a month
+@G_DATE_YEAR: a year
<!-- ##### TYPEDEF GDateDay ##### -->
<para>
@dir:
+<!-- ##### STRUCT GMappedFile ##### -->
+<para>
+The #GMappedFile represents a file mapping created with
+g_mapped_file_new(). It has only private members and should
+not be accessed directly.
+</para>
+
+
+<!-- ##### FUNCTION g_mapped_file_new ##### -->
+<para>
+
+</para>
+
+@filename:
+@writable:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_mapped_file_free ##### -->
+<para>
+
+</para>
+
+@file:
+
+
+<!-- ##### FUNCTION g_mapped_file_get_length ##### -->
+<para>
+
+</para>
+
+@file:
+@Returns:
+
+
+<!-- ##### FUNCTION g_mapped_file_get_contents ##### -->
+<para>
+
+</para>
+
+@file:
+@Returns:
+
+
<!-- ##### FUNCTION g_open ##### -->
<para>
@G_HOOK_FLAG_ACTIVE: set if the hook has not been destroyed.
@G_HOOK_FLAG_IN_CALL: set if the hook is currently being run.
-@G_HOOK_FLAG_MASK:
+@G_HOOK_FLAG_MASK: A mask covering all bits reserved for
+ hook flags; see #G_HOOK_FLAGS_USER_SHIFT
+
<!-- ##### MACRO G_HOOK_FLAGS ##### -->
<para>
g_io_channel_write(), and g_io_channel_seek().
</para>
-@G_IO_ERROR_NONE:
-@G_IO_ERROR_AGAIN:
-@G_IO_ERROR_INVAL:
-@G_IO_ERROR_UNKNOWN:
+@G_IO_ERROR_NONE: no error
+@G_IO_ERROR_AGAIN: an EAGAIN error occurred
+@G_IO_ERROR_INVAL: an EINVAL error occurred
+@G_IO_ERROR_UNKNOWN: another error occurred
<!-- ##### FUNCTION g_io_channel_write ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION g_build_filenamev ##### -->
+<para>
+
+</para>
+
+@args:
+@Returns:
+
+
<!-- ##### FUNCTION g_build_path ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION g_build_pathv ##### -->
+<para>
+
+</para>
+
+@separator:
+@args:
+@Returns:
+
+
<!-- ##### FUNCTION g_find_program_in_path ##### -->
<para>
Used in g_parse_debug_string().
</para>
-@key:
-@value:
+@key: the string
+@value: the flag
<!-- ##### USER_FUNCTION GVoidFunc ##### -->
<para>
</para>
+<!-- ##### SECTION Stability_Level ##### -->
+
+
<!-- ##### ENUM GOptionError ##### -->
<para>
Error codes returned by option parsing.
</para>
@context The active #GOptionContext
-
-@context:
@group: The group to which the function belongs
@data: User data added to the #GOptionGroup containing the option when it
was created with g_option_group_new()
</para>
@context The active #GOptionContext
-
-@context:
@group: The group to which the function belongs
@data: User data added to the #GOptionGroup containing the option when it
was created with g_option_group_new()
<!-- ##### STRUCT GOnce ##### -->
<para>
-A <structname>GOnce</structname> struct controls a one-time initialization function.
-Any one-time initialization function must have its own unique <structname>GOnce</structname>
-struct.
+A <structname>GOnce</structname> struct controls a one-time initialization
+function. Any one-time initialization function must have its own unique
+<structname>GOnce</structname> struct.
</para>
-@status:
-@retval:
+@status: the status of the #GOnce
+@retval: the value returned by the call to the function, if @status
+ is %G_ONCE_STATUS_READY
@Since: 2.4
<!-- ##### ENUM GOnceStatus ##### -->
<!-- ##### MACRO g_once ##### -->
<para>
-The first call to this routine by a process with a given #GOnce struct calls @func with the given
-argument. Thereafter, subsequent calls to g_once() with the same #GOnce struct do not call @func
-again, but return the stored result of the first call. On return from g_once(), the status of @once
-will be %G_ONCE_STATUS_READY.
+The first call to this routine by a process with a given #GOnce struct calls
+@func with the given argument. Thereafter, subsequent calls to g_once() with
+the same #GOnce struct do not call @func again, but return the stored result
+of the first call. On return from g_once(), the status of @once will be
+%G_ONCE_STATUS_READY.
</para>
<para>
-For example, a mutex or a thread-specific data key must be created exactly once. In a threaded
-environment, calling g_once() ensures that the initialization is serialized across multiple threads.
+For example, a mutex or a thread-specific data key must be created exactly
+once. In a threaded environment, calling g_once() ensures that the
+initialization is serialized across multiple threads.
</para>
<note><para>
-Calling g_once() recursively on the same #GOnce struct in @func will lead to a deadlock.
+Calling g_once() recursively on the same #GOnce struct in @func will lead
+to a deadlock.
</para></note>
<para>
<informalexample>
</para>
@once: a #GOnce structure
-@func: the function associated to @once. This function is called only once, regardless of the
- number of times it and its associated #GOnce struct are passed to g_once() .
+@func: the function associated to @once. This function is called only once,
+ regardless of the number of times it and its associated #GOnce struct
+ are passed to g_once() .
@arg: data to be passed to @func
@Since: 2.4