Updates

docs/reference/ChangeLog

@@ -1,3 +1,14 @@
+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.

docs/reference/glib/glib-sections.txt

@@ -985,6 +985,7 @@ g_file_test
 g_mkstemp
 g_file_open_tmp
 g_file_read_link
+g_mkdir_with_parents
 
 <SUBSECTION>
 GDir
@@ -1311,6 +1312,7 @@ g_get_system_data_dirs
 g_get_system_config_dirs
 
 <SUBSECTION>
+g_get_host_name
 g_get_home_dir
 g_get_tmp_dir
 g_get_current_dir

docs/reference/glib/tmpl/date.sgml

@@ -125,12 +125,14 @@ date becomes valid after you set it to a Julian day or you set a day,
 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>
@@ -144,9 +146,9 @@ This enumeration isn't used in the API, but may be useful if you need
 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>

docs/reference/glib/tmpl/fileutils.sgml

@@ -262,6 +262,51 @@ An opaque structure representing an opened directory.
 @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>
 

docs/reference/glib/tmpl/hooks.sgml

@@ -346,7 +346,9 @@ Flags used internally in the #GHook implementation.
 
 @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>

docs/reference/glib/tmpl/iochannels.sgml

@@ -564,10 +564,10 @@ g_io_channel_set_flags().
 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>

docs/reference/glib/tmpl/misc_utils.sgml

@@ -233,6 +233,15 @@ The returned string should be freed when no longer needed.
 @Returns: 
 
 
+<!-- ##### FUNCTION g_build_filenamev ##### -->
+<para>
+
+</para>
+
+@args: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_build_path ##### -->
 <para>
 
@@ -244,6 +253,16 @@ The returned string should be freed when no longer needed.
 @Returns: 
 
 
+<!-- ##### FUNCTION g_build_pathv ##### -->
+<para>
+
+</para>
+
+@separator: 
+@args: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_find_program_in_path ##### -->
 <para>
 
@@ -330,8 +349,8 @@ Associates a string with a bit flag.
 Used in g_parse_debug_string().
 </para>
 
-@key: 
-@value: 
+@key: the string
+@value: the flag
 
 <!-- ##### USER_FUNCTION GVoidFunc ##### -->
 <para>

docs/reference/glib/tmpl/option.sgml

@@ -124,6 +124,9 @@ main (int argc, char *argv[])
 
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
 <!-- ##### ENUM GOptionError ##### -->
 <para>
 Error codes returned by option parsing.
@@ -431,8 +434,6 @@ The type of function that can be called before and after 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()
@@ -458,8 +459,6 @@ occurs.
 </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()

docs/reference/glib/tmpl/threads.sgml

@@ -1621,13 +1621,14 @@ you should also free the #GStaticPrivate.
 
 <!-- ##### 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 ##### -->
@@ -1657,17 +1658,20 @@ GOnce my_once = G_ONCE_INIT;
 
 <!-- ##### 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>
@@ -1686,8 +1690,9 @@ get_debug_flags ()
 </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