2004-10-26 Matthias Clasen <mclasen@redhat.com>
+ * glib/gkeyfile.c (g_key_file_new): Fix docs.
+
+ * glib/gkeyfile.h: Use the same parameter names as in
+ the implementation and the docs.
+
* glib/gwin32.c (g_win32_get_windows_version): Make this
function thread-safe in the GLib style.
* glib/gthreadinit.h:
2004-10-26 Matthias Clasen <mclasen@redhat.com>
+ * glib/gkeyfile.c (g_key_file_new): Fix docs.
+
+ * glib/gkeyfile.h: Use the same parameter names as in
+ the implementation and the docs.
+
* glib/gwin32.c (g_win32_get_windows_version): Make this
function thread-safe in the GLib style.
* glib/gthreadinit.h:
2004-10-26 Matthias Clasen <mclasen@redhat.com>
+ * glib/gkeyfile.c (g_key_file_new): Fix docs.
+
+ * glib/gkeyfile.h: Use the same parameter names as in
+ the implementation and the docs.
+
* glib/gwin32.c (g_win32_get_windows_version): Make this
function thread-safe in the GLib style.
* glib/gthreadinit.h:
2004-10-26 Matthias Clasen <mclasen@redhat.com>
+ * glib/gkeyfile.c (g_key_file_new): Fix docs.
+
+ * glib/gkeyfile.h: Use the same parameter names as in
+ the implementation and the docs.
+
* glib/gwin32.c (g_win32_get_windows_version): Make this
function thread-safe in the GLib style.
* glib/gthreadinit.h:
2004-10-26 Matthias Clasen <mclasen@redhat.com>
+ * glib/gkeyfile.c (g_key_file_new): Fix docs.
+
+ * glib/gkeyfile.h: Use the same parameter names as in
+ the implementation and the docs.
+
* glib/gwin32.c (g_win32_get_windows_version): Make this
function thread-safe in the GLib style.
* glib/gthreadinit.h:
+2004-10-26 Matthias Clasen <mclasen@redhat.com>
+
+ * gobject/gobject-sections.txt: Additions.
+
+ * gobject/Makefile.am (IGNORE_HFILES): Add gobjectalias.h
+
+ * glib/tmpl/main.sgml: Document GChildWatchFunc
+
+ * glib/tmpl/keyfile.sgml: New template.
+
+ * glib/glib-sections.txt: Additions.
+
+ * glib/tmpl/macros_misc.sgml: Document some more of
+ the macros.
+
2004-10-25 Matthias Clasen <mclasen@redhat.com>
* glib/glib-docs.sgml: Add GKeyFile section, add
<SUBSECTION Private>
g_return_if_fail_warning
+g_assert_warning
</SECTION>
<SECTION>
g_option_group_set_translate_func
g_option_group_set_translation_domain
<SUBSECTION Private>
-g_option_context_error_quark
+g_option_error_quark
</SECTION>
g_key_file_get_keys
g_key_file_has_group
g_key_file_has_key
-g_key_file_remove_group
-g_key_file_remove_key
<SUBSECTION>
g_key_file_get_value
-g_key_file_set_value
g_key_file_get_string
-g_key_file_set_string
g_key_file_get_locale_string
-g_key_file_set_locale_string
g_key_file_get_boolean
-g_key_file_set_boolean
g_key_file_get_integer
-g_key_file_set_integer
g_key_file_get_string_list
-g_key_file_set_string_list
g_key_file_get_locale_string_list
-g_key_file_set_locale_string_list
g_key_file_get_boolean_list
-g_key_file_set_boolean_list
g_key_file_get_integer_list
+g_key_file_get_comment
+
+<SUBSECTION>
+g_key_file_set_value
+g_key_file_set_string
+g_key_file_set_locale_string
+g_key_file_set_boolean
+g_key_file_set_integer
+g_key_file_set_string_list
+g_key_file_set_locale_string_list
+g_key_file_set_boolean_list
g_key_file_set_integer_list
+g_key_file_set_comment
+g_key_file_remove_group
+g_key_file_remove_key
+g_key_file_remove_comment
+
<SUBSECTION Private>
g_key_file_error_quark
</SECTION>
MAXPATHLEN
pid_t
pipe
-ftruncate
g_win32_error_message
g_win32_getlocale
g_filename_from_utf8
g_filename_from_uri
g_filename_to_uri
+g_uri_list_extract_uris
g_locale_from_utf8
GConvertError
@Returns:
+<!-- ##### FUNCTION g_uri_list_extract_uris ##### -->
+<para>
+
+</para>
+
+@uri_list:
+@Returns:
+
+
<!-- ##### FUNCTION g_locale_from_utf8 ##### -->
<para>
+<!-- ##### SECTION ./tmpl/desktop_entry.sgml:Long_Description ##### -->
+<para>
+The "GDesktopEntry" parser is intended to parse files written to
+the <ulink
+url="http://www.freedesktop.org/Standards/desktop-entry-spec">Desktop
+Entry Specification</ulink>. It supports deserialization of
+desktop entries from files and in-memory data. Desktop entries
+are used for a variety of things including menus, application
+MIME type registration, and launchers.
+</para>
+
+<para>
+To load an existing desktop entry from a data directory (as
+returned by g_get_user_data_dir() and g_get_system_data_dirs())
+use g_desktop_entry_new_from_data_dirs(). To load an existing
+desktop entry from an arbitrary location on the file system use
+g_desktop_entry_new_from_file(). If the desktop entry is already
+in memory use g_desktop_entry_new_from_data(). Once the desktop
+entry is loaded its keys can be queried using the g_desktop_entry_get
+family of functions.
+</para>
+
+<para>
+To create a new desktop entry first call g_desktop_entry_new().
+Then, call the g_desktop_entry_set family of functions. Next,
+call g_desktop_entry_to_data() to output the desktop entry to
+a byte array, which can be written to disk or sent over a
+network. Finally, call g_desktop_entry_free() to deallocate the
+#GDesktopEntry object returned by g_desktop_entry_new().
+</para>
+
+
+<!-- ##### SECTION ./tmpl/desktop_entry.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/desktop_entry.sgml:Short_Description ##### -->
+serializes and deserializes a desktop entry.
+
+
+<!-- ##### SECTION ./tmpl/desktop_entry.sgml:Title ##### -->
+Desktop Entry Parser
+
+
<!-- ##### ENUM GChannelError ##### -->
<para>
@s2:
@Returns:
+<!-- ##### STRUCT GDesktopEntry ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM GDesktopEntryError ##### -->
+<para>
+Error codes returned by desktop entry parsing.
+</para>
+
+@G_DESKTOP_ENTRY_ERROR_UNKNOWN_ENCODING: text being parsed is not UTF-8 and
+cannot be guessed.
+@G_DESKTOP_ENTRY_ERROR_BAD_START_GROUP: desktop entry does not start with a
+legal start group.
+@G_DESKTOP_ENTRY_ERROR_PARSE: desktop entry is empty or contains invalid
+data.
+@G_DESKTOP_ENTRY_ERROR_NOT_FOUND: valid desktop entry could not be found.
+@G_DESKTOP_ENTRY_ERROR_KEY_NOT_FOUND: desktop entry does not have requested
+key.
+@G_DESKTOP_ENTRY_ERROR_GROUP_NOT_FOUND: desktop entry does not have requested
+group
+@G_DESKTOP_ENTRY_ERROR_INVALID_VALUE: desktop entry contains key which has
+value that cannot be validated.
+
+<!-- ##### ENUM GDesktopEntryFlags ##### -->
+<para>
+#GDesktopEntry supports a few flags for tweaking performance during
+deserialization. #G_DESKTOP_ENTRY_DISCARD_COMMENTS and
+#G_DESKTOP_ENTRY_DISCARD_TRANSLATIONS will reduce memory footprint,
+and #G_DESKTOP_ENTRY_GENERATE_LOOKUP_MAP will increase key lookup speed.
+</para>
+
+@G_DESKTOP_ENTRY_NONE: use parser defaults
+@G_DESKTOP_ENTRY_DISCARD_COMMENTS: Discard all lines that are blank
+or start with "#".
+@G_DESKTOP_ENTRY_DISCARD_TRANSLATIONS: Only retain translations that
+are returned by g_get_language_names().
+@G_DESKTOP_ENTRY_GENERATE_LOOKUP_MAP: Generate a lookup map for key names to make lookups constant time at the cost of more memory.
+
<!-- ##### USER_FUNCTION GErrorFunc ##### -->
<para>
Specifies the type of function passed to g_set_error_handler().
</para>
+<!-- ##### MACRO G_DESKTOP_ENTRY_ERROR ##### -->
+<para>
+Error domain for desktop entry parsing. Errors in this domain will
+be from the #GDesktopEntryError enumeration. See #GError for information on
+error domains.
+</para>
+
+
<!-- ##### MACRO G_HOOK_DEFERRED_DESTROY ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION g_get_language_names ##### -->
+<!-- ##### FUNCTION g_desktop_entry_escape_strings ##### -->
+<para>
+
+</para>
+
+@entry:
+@should_escape:
+
+<!-- ##### FUNCTION g_desktop_entry_free ##### -->
+<para>
+
+</para>
+
+@entry:
+
+<!-- ##### FUNCTION g_desktop_entry_get_boolean ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_boolean_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@length:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_groups ##### -->
+<para>
+
+</para>
+
+@entry:
+@length:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_integer ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_integer_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@length:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_keys ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@length:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_locale_string ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@locale:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_locale_string_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@locale:
+@length:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_get_start_group ##### -->
<para>
</para>
+@entry:
@Returns:
-<!-- ##### FUNCTION g_get_system_config_dirs ##### -->
+<!-- ##### FUNCTION g_desktop_entry_get_string ##### -->
<para>
</para>
+@entry:
+@group_name:
+@key:
+@error:
@Returns:
-<!-- ##### FUNCTION g_get_system_data_dirs ##### -->
+<!-- ##### FUNCTION g_desktop_entry_get_string_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@length:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_has_group ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_has_key ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_new ##### -->
+<para>
+
+</para>
+
+@flags:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_new_from_data ##### -->
+<para>
+
+</para>
+
+@data:
+@length:
+@legal_start_groups:
+@flags:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_new_from_data_dirs ##### -->
+<para>
+
+</para>
+
+@file:
+@full_path:
+@legal_start_groups:
+@flags:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_new_from_file ##### -->
+<para>
+
+</para>
+
+@file:
+@legal_start_groups:
+@flags:
+@error:
+@Returns:
+
+<!-- ##### FUNCTION g_desktop_entry_remove_group ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_remove_key ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_boolean ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@boolean:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_boolean_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@list:
+@length:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_integer ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@integer:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_integer_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@list:
+@length:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_locale_string ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@locale:
+@string:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_locale_string_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@locale:
+@list:
+@length:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_string ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@string:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_set_string_list ##### -->
+<para>
+
+</para>
+
+@entry:
+@group_name:
+@key:
+@list:
+@length:
+@error:
+
+<!-- ##### FUNCTION g_desktop_entry_to_data ##### -->
<para>
</para>
+@entry:
+@length:
+@error:
@Returns:
<!-- ##### FUNCTION g_io_channel_error_quark ##### -->
@Returns:
+<!-- ##### FUNCTION g_get_language_names ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
--- /dev/null
+<!-- ##### SECTION Title ##### -->
+Key-value file parser
+
+<!-- ##### SECTION Short_Description ##### -->
+parses <filename>.ini</filename>-like config files
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GKeyFile ##### -->
+<para>
+The <structname>GKeyFile</structname> struct contains only private fields
+and should not be used directly.
+</para>
+
+
+<!-- ##### MACRO G_KEY_FILE_ERROR ##### -->
+<para>
+Error domain for key file parsing. Errors in this domain will
+be from the #GKeyFileError enumeration. See #GError for information on
+error domains.
+</para>
+
+
+
+<!-- ##### ENUM GKeyFileError ##### -->
+<para>
+Error codes returned by key file parsing.
+</para>
+
+@G_KEY_FILE_ERROR_UNKNOWN_ENCODING: the text being parsed was in an unknown encoding
+@G_KEY_FILE_ERROR_PARSE: document was ill-formed
+@G_KEY_FILE_ERROR_NOT_FOUND: the file was not found
+@G_KEY_FILE_ERROR_KEY_NOT_FOUND: a requested key was not found
+@G_KEY_FILE_ERROR_GROUP_NOT_FOUND: a requested group was not found
+@G_KEY_FILE_ERROR_INVALID_VALUE: a value could not be parsed
+
+<!-- ##### ENUM GKeyFileFlags ##### -->
+<para>
+Flags which influence the parsing.
+</para>
+
+@G_KEY_FILE_NONE: No flags, default behaviour
+@G_KEY_FILE_KEEP_COMMENTS: Use this flag if you plan to write the (possibly modified)
+ contents of the key file back to a file; otherwise all comments will be lost when
+ the key file is written back.
+@G_KEY_FILE_KEEP_TRANSLATIONS: Use this flag if you plan to write the (possibly modified)
+ contents of the key file back to a file; otherwise only the translations for the current
+ language will be written back.
+
+<!-- ##### FUNCTION g_key_file_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_free ##### -->
+<para>
+
+</para>
+
+@key_file:
+
+
+<!-- ##### FUNCTION g_key_file_set_list_separator ##### -->
+<para>
+
+</para>
+
+@key_file:
+@separator:
+
+
+<!-- ##### FUNCTION g_key_file_load_from_file ##### -->
+<para>
+
+</para>
+
+@key_file:
+@file:
+@flags:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_load_from_data ##### -->
+<para>
+
+</para>
+
+@key_file:
+@data:
+@length:
+@flags:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_load_from_data_dirs ##### -->
+<para>
+
+</para>
+
+@key_file:
+@file:
+@full_path:
+@flags:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_to_data ##### -->
+<para>
+
+</para>
+
+@key_file:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_start_group ##### -->
+<para>
+
+</para>
+
+@key_file:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_groups ##### -->
+<para>
+
+</para>
+
+@key_file:
+@length:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_keys ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_has_group ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_has_key ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_value ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_string ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_locale_string ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@locale:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_boolean ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_integer ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_string_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_locale_string_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@locale:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_boolean_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_integer_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_get_comment ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION g_key_file_set_value ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@value:
+
+
+<!-- ##### FUNCTION g_key_file_set_string ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@string:
+
+
+<!-- ##### FUNCTION g_key_file_set_locale_string ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@locale:
+@string:
+
+
+<!-- ##### FUNCTION g_key_file_set_boolean ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@value:
+<!-- # Unused Parameters # -->
+@boolean:
+
+
+<!-- ##### FUNCTION g_key_file_set_integer ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@value:
+<!-- # Unused Parameters # -->
+@integer:
+
+
+<!-- ##### FUNCTION g_key_file_set_string_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@list:
+@length:
+
+
+<!-- ##### FUNCTION g_key_file_set_locale_string_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@locale:
+@list:
+@length:
+
+
+<!-- ##### FUNCTION g_key_file_set_boolean_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@list:
+@length:
+
+
+<!-- ##### FUNCTION g_key_file_set_integer_list ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@list:
+@length:
+
+
+<!-- ##### FUNCTION g_key_file_set_comment ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@comment:
+@error:
+
+
+<!-- ##### FUNCTION g_key_file_remove_group ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@error:
+
+
+<!-- ##### FUNCTION g_key_file_remove_key ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+
+
+<!-- ##### FUNCTION g_key_file_remove_comment ##### -->
+<para>
+
+</para>
+
+@key_file:
+@group_name:
+@key:
+@error:
+
+
<!-- ##### MACRO G_HAVE_GNUC_VISIBILITY ##### -->
<para>
-
+This macro is defined as 1 if the the compiler supports ELF visibility
+attributes (currently only <command>gcc</command>).
</para>
+Since: 2.6
<!-- ##### MACRO G_GNUC_INTERNAL ##### -->
<para>
Expands to the GNU C <literal>visibility(hidden)</literal> attribute if the
-compiler is <command>gcc</command>. This attribute can be used for marking
-library functions as being used internally to the lib only, to not create
-inefficient PLT entries. Note that static functions do not need to be marked
-as internal in this way. See the GNU C documentation for details.
+compiler supports it (currently only <command>gcc</command>). This attribute
+can be used for marking library functions as being used internally to the lib
+only, to not create inefficient PLT entries. Note that static functions do not
+need to be marked as internal in this way. See the GNU C documentation for details.
</para>
Since: 2.6
<!-- ##### MACRO G_STRFUNC ##### -->
<para>
-
+Expands to a string identifying the current function.
</para>
+@Since: 2.4
<!-- ##### MACRO G_GINT16_MODIFIER ##### -->
<para>
The platform dependent length modifier for constructing printf() conversion
-specifiers for values of type #gint16. It is a string literal, but doesn't
-include the percent-sign, such that you can add precision and length
-modifiers between percent-sign and conversion specifier and append a
+specifiers for values of type #gint16 or #guint16. It is a string literal,
+but doesn't include the percent-sign, such that you can add precision and
+length modifiers between percent-sign and conversion specifier and append a
conversion specifier.
</para>
<!-- ##### MACRO G_GINT32_MODIFIER ##### -->
<para>
The platform dependent length modifier for constructing printf() conversion
-specifiers for values of type #gint32. See also #G_GINT16_MODIFIER.
+specifiers for values of type #gint32 or #guint32. See also #G_GINT16_MODIFIER.
</para>
@Since: 2.4
<!-- ##### MACRO G_GINT64_MODIFIER ##### -->
<para>
The platform dependent length modifier for constructing printf() conversion
-specifiers for values of type #gint64. See also #G_GINT16_MODIFIER.
+specifiers for values of type #gint64 or #guint64. See also #G_GINT16_MODIFIER.
</para>
<note>
<!-- ##### MACRO G_GSIZE_MODIFIER ##### -->
<para>
-
+The platform dependent length modifier for constructing printf() conversion
+specifiers for values of type #gsize or #gssize. See also #G_GINT16_MODIFIER.
</para>
+@Since: 2.6
<!-- ##### MACRO G_GSIZE_FORMAT ##### -->
<para>
-
+This is the platform dependent conversion specifier for scanning and
+printing values of type #gsize. See also #G_GINT16_FORMAT.
</para>
+@Since: 2.6
<!-- ##### MACRO G_GSSIZE_FORMAT ##### -->
<para>
-
+This is the platform dependent conversion specifier for scanning and
+printing values of type #gssize. See also #G_GINT16_FORMAT.
</para>
+@Since: 2.6
<!-- ##### TYPEDEF GPid ##### -->
<para>
-
+A type which is used to hold a process identification.
+On Unix, processes are identified by a process id (an
+integer), while Windows uses process handles (which are
+pointers).
</para>
<!-- ##### USER_FUNCTION GChildWatchFunc ##### -->
<para>
-
+The type of functions to be called when a child exists.
</para>
-@pid:
-@status:
-@data:
+@pid: the process id of the child process
+@status: Status information about the child process,
+ see waitpid(2) for more information about this field
+@data: user data passed to g_child_watch_add()
<!-- ##### FUNCTION g_child_watch_source_new ##### -->
@Returns:
+<!-- ##### FUNCTION g_get_system_data_dirs ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION g_get_system_config_dirs ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
<!-- ##### FUNCTION g_get_home_dir ##### -->
<para>
Gets the current user's home directory.
HFILE_GLOB=$(top_srcdir)/gobject/*.h
CFILE_GLOB=$(top_srcdir)/gobject/*.c
+# Headers to ignore
+IGNORE_HFILES=gobjectalias.h
+
# CFLAGS and LDFLAGS for compiling scan program. Only needed
# if $(DOC_MODULE).types is non-empty.
INCLUDES = \
<SUBSECTION Private>
GOBJECT_VAR
+g_value_c_init
+g_value_types_init
+g_enum_types_init
+g_param_type_init
+g_boxed_type_init
+g_object_type_init
+g_param_spec_types_init
+g_value_transforms_init
+g_signal_init
</SECTION>
<SECTION>
/**
* g_key_file_new:
- * @flags: flags from #GKeyFileFlags
*
* Creates a new empty #GKeyFile object. Use g_key_file_load_from_file(),
* g_key_file_load_from_data() or g_key_file_load_from_data_dirs() to
void g_key_file_set_boolean (GKeyFile *key_file,
const gchar *group_name,
const gchar *key,
- gboolean boolean);
+ gboolean value);
gint g_key_file_get_integer (GKeyFile *key_file,
const gchar *group_name,
const gchar *key,
void g_key_file_set_integer (GKeyFile *key_file,
const gchar *group_name,
const gchar *key,
- gint integer);
+ gint value);
gchar **g_key_file_get_string_list (GKeyFile *key_file,
const gchar *group_name,
const gchar *key,