keyfile.sgml

This GLib version 2.16.1. GLib is the low-level core library that forms the basis for projects such

@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: 


<!-- ##### FUNCTION g_key_file_set_integer ##### -->
<para>

</para>

@key_file: 
@group_name: 
@key: 
@value: 


<!-- ##### FUNCTION g_key_file_set_double ##### -->
<para>

</para>

@key_file: 
@group_name: 
@key: 
@value: 


<!-- ##### 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_double_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: 
@Returns: 


<!-- ##### FUNCTION g_key_file_remove_group ##### -->
<para>

</para>

@key_file: 
@group_name: 
@error: 
@Returns: 


<!-- ##### FUNCTION g_key_file_remove_key ##### -->
<para>

</para>

@key_file: 
@group_name: 
@key: 
@error: 
@Returns: 


<!-- ##### FUNCTION g_key_file_remove_comment ##### -->
<para>

</para>

@key_file: 
@group_name: 
@key: 
@error: 
@Returns: 


<!-- ##### MACRO G_KEY_FILE_DESKTOP_GROUP ##### -->
<para>
The name of the main group of a desktop entry file, as defined in the
<ulink url="http://freedesktop.org/Standards/desktop-entry-spec">Desktop
Entry Specification</ulink>. Consult the specification for more
details about the meanings of the keys below.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_TYPE ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a string giving the type of the desktop entry. Usually
<link linkend="G-KEY-FILE-DESKTOP-TYPE-APPLICATION:CAPS"><literal>G_KEY_FILE_DESKTOP_TYPE_APPLICATION</literal></link>,
<link linkend="G-KEY-FILE-DESKTOP-TYPE-LINK:CAPS"><literal>G_KEY_FILE_DESKTOP_TYPE_LINK</literal></link>, or
<link linkend="G-KEY-FILE-DESKTOP-TYPE-DIRECTORY:CAPS"><literal>G_KEY_FILE_DESKTOP_TYPE_DIRECTORY</literal></link>.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_VERSION ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a string giving the version of the Desktop
Entry Specification used for the desktop entry file.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_NAME ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a localized string giving the specific name of the
desktop entry.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a localized string giving the generic name of the
desktop entry.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a boolean stating whether the desktop entry should be
shown in menus.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_COMMENT ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a localized string giving the tooltip for the desktop
entry.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_ICON ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a localized string giving the name of the icon to be
displayed for the desktop entry.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_HIDDEN ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a boolean stating whether the desktop entry has been
deleted by the user.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a list of strings identifying the environments that
should display the desktop entry.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a list of strings identifying the environments that
should not display the desktop entry.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_TRY_EXEC ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a string giving the file name of a binary on disk
used to determine if the program is actually installed. It is only
valid for desktop entries with the <literal>Application</literal>
type.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_EXEC ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a string giving the command line to execute. It is only
valid for desktop entries with the <literal>Application</literal>
type.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_PATH ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a string containing the working directory to run the
program in. It is only valid for desktop entries with the
<literal>Application</literal> type.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_TERMINAL ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a boolean stating whether the program should be
run in a terminal window. It is only valid for desktop entries with
the <literal>Application</literal> type.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_MIME_TYPE ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a list of strings giving the MIME types supported
by this desktop entry.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_CATEGORIES ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a list of strings giving the categories in which the
desktop entry should be shown in a menu.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a boolean stating whether the application supports
the <ulink
url="http://www.freedesktop.org/Standards/startup-notification-spec">Startup
Notification Protocol Specification</ulink>.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is string identifying the WM class or name hint of a
window that the application will create, which can be used to emulate
Startup Notification with older applications.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_KEY_URL ##### -->
<para>
A key under <link
linkend="G-KEY-FILE-DESKTOP-GROUP:CAPS"><literal>G_KEY_FILE_DESKTOP_GROUP</literal></link>
whose value is a string giving the URL to access. It is only valid
for desktop entries with the <literal>Link</literal> type.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_TYPE_APPLICATION ##### -->
<para>
The value of the <link
linkend="G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS"><literal>G_KEY_FILE_DESKTOP_KEY_TYPE</literal></link>
key for desktop entries representing applications.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_TYPE_LINK ##### -->
<para>
The value of the <link
linkend="G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS"><literal>G_KEY_FILE_DESKTOP_KEY_TYPE</literal></link>
key for desktop entries representing links to documents.
</para>

@Since: 2.14


<!-- ##### MACRO G_KEY_FILE_DESKTOP_TYPE_DIRECTORY ##### -->
<para>
The value of the <link
linkend="G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS"><literal>G_KEY_FILE_DESKTOP_KEY_TYPE</literal></link>
key for desktop entries representing directories.
</para>

@Since: 2.14