<HTML
><HEAD
><TITLE
>gnome-config</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome Library"
HREF="libgnome.html"><LINK
REL="PREVIOUS"
TITLE="Gnome Library"
HREF="libgnome.html"><LINK
REL="NEXT"
TITLE="gnome-defs"
HREF="gnome-gnome-defs.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-gnome-defs.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOME-GNOME-CONFIG"
>gnome-config</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN11"
></A
><H2
>Name</H2
>gnome-config&nbsp;--&nbsp;Simple access to configuration values (50% done)</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN14"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-STRING-WITH-DEFAULT"
>gnome_config_get_string_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-TRANSLATED-STRING-WITH-DEFAULT"
>gnome_config_get_translated_string_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-INT-WITH-DEFAULT"
>gnome_config_get_int_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-FLOAT-WITH-DEFAULT"
>gnome_config_get_float_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-BOOL-WITH-DEFAULT"
>gnome_config_get_bool_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-VECTOR-WITH-DEFAULT"
>gnome_config_get_vector_with_default</A
>(path, argcp, argvp, def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-STRING-WITH-DEFAULT"
>gnome_config_private_get_string_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-TRANSLATED-STRING-WITH-DEFAULT"
>gnome_config_private_get_translated_string_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-INT-WITH-DEFAULT"
>gnome_config_private_get_int_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-FLOAT-WITH-DEFAULT"
>gnome_config_private_get_float_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-BOOL-WITH-DEFAULT"
>gnome_config_private_get_bool_with_default</A
>(path,def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-VECTOR-WITH-DEFAULT"
>gnome_config_private_get_vector_with_default</A
>(path, argcp, argvp, def)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-STRING"
>gnome_config_get_string</A
>         (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-TRANSLATED-STRING"
>gnome_config_get_translated_string</A
>(path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-INT"
>gnome_config_get_int</A
>            (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-FLOAT"
>gnome_config_get_float</A
>          (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-BOOL"
>gnome_config_get_bool</A
>           (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-VECTOR"
>gnome_config_get_vector</A
>         (path, argcp, argvp)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-STRING"
>gnome_config_private_get_string</A
> (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-TRANSLATED-STRING"
>gnome_config_private_get_translated_string</A
>(path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-INT"
>gnome_config_private_get_int</A
>    (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-FLOAT"
>gnome_config_private_get_float</A
>  (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-BOOL"
>gnome_config_private_get_bool</A
>   (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-VECTOR"
>gnome_config_private_get_vector</A
> (path, argcp, argvp)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-STRING"
>gnome_config_set_string</A
>         (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-TRANSLATED-STRING"
>gnome_config_set_translated_string</A
>(path,value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-INT"
>gnome_config_set_int</A
>            (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-FLOAT"
>gnome_config_set_float</A
>          (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-BOOL"
>gnome_config_set_bool</A
>           (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-VECTOR"
>gnome_config_set_vector</A
>         (path,argc,argv)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-SET-STRING"
>gnome_config_private_set_string</A
> (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-SET-TRANSLATED-STRING"
>gnome_config_private_set_translated_string</A
>(path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-SET-INT"
>gnome_config_private_set_int</A
>    (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-SET-FLOAT"
>gnome_config_private_set_float</A
>  (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-SET-BOOL"
>gnome_config_private_set_bool</A
>   (path,new_value)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-SET-VECTOR"
>gnome_config_private_set_vector</A
> (path,argc,argv)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-HAS-SECTION"
>gnome_config_has_section</A
>        (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-HAS-SECTION"
>gnome_config_private_has_section</A
>(path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-INIT-ITERATOR"
>gnome_config_init_iterator</A
>      (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-INIT-ITERATOR"
>gnome_config_private_init_iterator</A
>(path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-INIT-ITERATOR-SECTIONS"
>gnome_config_init_iterator_sections</A
>(path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-INIT-ITERATOR-SECTIONS"
>gnome_config_private_init_iterator_sections</A
>(path)
void*       <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-ITERATOR-NEXT"
>gnome_config_iterator_next</A
>      (void *iterator_handle,
                                             char **key,
                                             char **value);
void        <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-DROP-ALL"
>gnome_config_drop_all</A
>           (void);
void        <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
>               (void);
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC-FILE"
>gnome_config_sync_file</A
>          (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-SYNC-FILE"
>gnome_config_private_sync_file</A
>  (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-DROP-FILE"
>gnome_config_drop_file</A
>          (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-DROP-FILE"
>gnome_config_private_drop_file</A
>  (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-CLEAN-FILE"
>gnome_config_clean_file</A
>         (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-CLEAN-FILE"
>gnome_config_private_clean_file</A
> (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-CLEAN-SECTION"
>gnome_config_clean_section</A
>      (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-CLEAN-SECTION"
>gnome_config_private_clean_section</A
>(path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-CLEAN-KEY"
>gnome_config_clean_key</A
>          (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-CLEAN-KEY"
>gnome_config_private_clean_key</A
>  (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-GET-REAL-PATH"
>gnome_config_get_real_path</A
>      (path)
#define     <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PRIVATE-GET-REAL-PATH"
>gnome_config_private_get_real_path</A
>(path)
void        <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-PUSH-PREFIX"
>gnome_config_push_prefix</A
>        (const char *path);
void        <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-POP-PREFIX"
>gnome_config_pop_prefix</A
>         (void);
void        <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-MAKE-VECTOR"
>gnome_config_make_vector</A
>        (const char *string,
                                             int *argcp,
                                             char ***argvp);
char*       <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-ASSEMBLE-VECTOR"
>gnome_config_assemble_vector</A
>    (int argc,
                                             const char *const argv[]);
void        <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-SET-HANDLER"
>gnome_config_set_set_handler</A
>    (void (*func) (void *),
                                             void *data);
void        <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SET-SYNC-HANDLER"
>gnome_config_set_sync_handler</A
>   (void (*func) (void *),
                                             void *data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN80"
></A
><H2
>Description</H2
><P
>gnome-config routines provide a simple way of retrieving and
storing configuration values (the routines provide handling of default
values to simplify the code).</P
><DIV
CLASS="FORMALPARA"
><P
><B
>Definitions. </B
></P
></DIV
><P
>    <P
></P
><UL
><LI
><P
><I
CLASS="EMPHASIS"
>config path:</I
> a string that
        specifies which item to retrieve from the configuration
        database.  The config path is composed of three elements: the
        first one is the filename where the information is stored, the
        second component is the section and the third one is the key
        inside the section</P
><P
>For example, a config path of "/myapp/toolbox/showit"
        could be used to retrieve the setting for whether 'myapp'
        should display its toolbox or not.  In this example "myapp" is
        the file name (which is stored in
        <TT
CLASS="FILENAME"
>~/.gnome</TT
> directory), "toolbox" is the
        section and "showit" is the key.</P
><P
>If you want to access an absolute file instead of a
        <TT
CLASS="FILENAME"
>~/.gnome</TT
>-relative file, then you need to
        surround the filename with equal signs, for example, to access
        the key "mykey" from the section "mysection" in a
        configuration file located in
        <TT
CLASS="FILENAME"
>/gnome/var/myconfig</TT
> you need to use this
        path: "=/gnome/var/myconfig=/mysection/mykey".</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>default:</I
> when retrieving a
        config item, specifies the value to be used if the item is not
        found.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>private configuration data</I
>
        - Normally, config item data is located in files under the
        ~user/.gnome directory in a .ini-like format. These files are
        world-readable. Items that have security or privacy
        implications are stored and retrieved using the "private"
        versions of the gnome-config routines, and the data for these
        items is stored in files under the ~user/.gnome_private
        directory, which is not accessable by anyone except that user
        and the system administrator.</P
></LI
><LI
><P
>"translated" strings - GNOME's multilingual
       	support means that multiple languages must be supported for
       	configuration items.  The
       	gnome_config_*<GTKDOCLINK
HREF="GET-TRANSLATED-STRING"
>get_translated_string</GTKDOCLINK
>() and
       	gnome_config_*<GTKDOCLINK
HREF="SET-TRANSLATED-STRING"
>set_translated_string</GTKDOCLINK
>() routines allow you to
       	specify which language a string item should be accessed for.
       	</P
></LI
><LI
><P
>"section" - a group of config items and other
      config sections</P
></LI
></UL
>
   </P
><DIV
CLASS="FORMALPARA"
><P
><B
>How Config Items are Read. </B
></P
></DIV
><P
>    GNOME has a versatile method of storing config items.  When a
    config item is written by a program, it is written to a file under
    the <TT
CLASS="FILENAME"
>~/.gnome</TT
> hierarchy.  However, when config
    items are read, the process is a little more complicated.  There
    are a number of places that are searched.  If the config item is
    not found in one, then the next place is checked, finally falling
    back to the default value provided by the application.  The
    locations are as follows:
    <P
></P
><UL
><LI
><P
><TT
CLASS="FILENAME"
>$(sysconfdir)/gnome/config-override</TT
>
        - a system administrator would put config items in this directory
        that they don't want to be configurable.</P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>~/.gnome</TT
> - this is where the
        user's config items are written to and is the next place that is
        searched</P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>$(sysconfdir)/gnome/config</TT
>
        - this directory would hold system wide default configuration values.
        </P
></LI
></UL
>
  </P
><P
>    Possible uses for this are setting system wide defaults such as
    proxy servers for the system (either using
    <TT
CLASS="FILENAME"
>config-override</TT
> to enforce such a policy or
    the <TT
CLASS="FILENAME"
>config</TT
> directory to suggest such a
    default).  It is also possible to configure the application
    through its graphical interface, and then copy the configuration
    file accross to the appropriate system-wide directory.
    The <TT
CLASS="FILENAME"
>config-override</TT
> directory should be used
    sparingly, as it could annoy or confuse some users.  Note also
    that some applications will not read the config items every time
    they are needed, so putting defaults into the
    <TT
CLASS="FILENAME"
>config-override</TT
> directory will not always
    completely enforce a setting.</P
><P
>There are two types of routines</P
><P
>FIXME: Finish this.  Explain the different types of routines,
explain the _private versions, explain the vector use, etc</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN128"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN130"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-STRING-WITH-DEFAULT"
></A
>gnome_config_get_string_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_string_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string.
The returned value should be <GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN150"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-TRANSLATED-STRING-WITH-DEFAULT"
></A
>gnome_config_get_translated_string_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_translated_string_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string appropriate for the current language. The returned value should be
<GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN170"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-INT-WITH-DEFAULT"
></A
>gnome_config_get_int_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_int_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as an integer.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN189"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-FLOAT-WITH-DEFAULT"
></A
>gnome_config_get_float_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_float_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a floating-point number.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN208"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-BOOL-WITH-DEFAULT"
></A
>gnome_config_get_bool_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_bool_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a boolean.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN227"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-VECTOR-WITH-DEFAULT"
></A
>gnome_config_get_vector_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_vector_with_default(path, argcp, argvp, def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string array.
The returned value should be <GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argcp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of elements in the vector</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argvp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vector of strings</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN255"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-STRING-WITH-DEFAULT"
></A
>gnome_config_private_get_string_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_string_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string.
The returned value should be <GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.  The
item is retrieved from the user's private configuration storage
area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN275"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-TRANSLATED-STRING-WITH-DEFAULT"
></A
>gnome_config_private_get_translated_string_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_translated_string_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string appropriate for the current language. The returned value should be
<GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN295"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-INT-WITH-DEFAULT"
></A
>gnome_config_private_get_int_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_int_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as an integer.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN314"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-FLOAT-WITH-DEFAULT"
></A
>gnome_config_private_get_float_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_float_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a floating-point number.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN333"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-BOOL-WITH-DEFAULT"
></A
>gnome_config_private_get_bool_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_bool_with_default(path,def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a boolean.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN352"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-VECTOR-WITH-DEFAULT"
></A
>gnome_config_private_get_vector_with_default()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_vector_with_default(path, argcp, argvp, def)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string array.
The returned value should be <GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.  The
item is retrieved from the user's private configuration storage
area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argcp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of elements in the vector</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argvp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vector of strings</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>def</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a flag that will be set if the default value for the item
is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN380"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-STRING"
></A
>gnome_config_get_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_string(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string.
The returned value should be
<GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN396"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-TRANSLATED-STRING"
></A
>gnome_config_get_translated_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_translated_string(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string
appropriate for the current language. The returned value should be
<GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN412"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-INT"
></A
>gnome_config_get_int()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_int(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as an integer.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN427"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-FLOAT"
></A
>gnome_config_get_float()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_float(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a floating-point
number.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN442"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-BOOL"
></A
>gnome_config_get_bool()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_bool(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a boolean.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN457"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-VECTOR"
></A
>gnome_config_get_vector()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_vector(path, argcp, argvp)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string array.
The returned value should be
<GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argcp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of elements in the vector</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argvp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vector of strings</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN481"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-STRING"
></A
>gnome_config_private_get_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_string(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a
string. The returned value should be <GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer
needed.  The item is retrieved from the user's private
configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN497"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-TRANSLATED-STRING"
></A
>gnome_config_private_get_translated_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_translated_string(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a string appropriate for the current language. The returned value should be
<GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer needed.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN513"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-INT"
></A
>gnome_config_private_get_int()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_int(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as an integer.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN528"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-FLOAT"
></A
>gnome_config_private_get_float()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_float(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a floating-point number.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN543"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-BOOL"
></A
>gnome_config_private_get_bool()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_bool(path)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a boolean.
The item is retrieved from the user's private configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN558"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-VECTOR"
></A
>gnome_config_private_get_vector()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_vector(path, argcp, argvp)</PRE
></TD
></TR
></TABLE
><P
>Retrieves &amp; returns the value of a configuration item as a
string. The returned value should be <GTKDOCLINK
HREF="G-FREE"
>g_free</GTKDOCLINK
>()'d when no longer
needed.  The item is retrieved from the user's private
configuration storage area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to an item in the user-private namespace.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argcp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of elements in the vector</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argvp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vector of strings</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN582"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-STRING"
></A
>gnome_config_set_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_set_string(path,new_value)</PRE
></TD
></TR
></TABLE
><P
>Stores the string value <TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
> in the file/section/key
defined by the <TT
CLASS="PARAMETER"
><I
>path</I
></TT
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a string value to set.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN603"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-TRANSLATED-STRING"
></A
>gnome_config_set_translated_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_set_translated_string(path,value)</PRE
></TD
></TR
></TABLE
><P
>Stores the string value <TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
> in the file/section/key defined
by the <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> on the proper section for the current language set by
by the user.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a string value to set.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN624"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-INT"
></A
>gnome_config_set_int()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_set_int(path,new_value)</PRE
></TD
></TR
></TABLE
><P
>Stores the integer value <TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
> in the file/section/key
defined by the <TT
CLASS="PARAMETER"
><I
>path</I
></TT
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a int value to set.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN645"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-FLOAT"
></A
>gnome_config_set_float()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_set_float(path,new_value)</PRE
></TD
></TR
></TABLE
><P
>Stores the double value <TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
> in the file/section/key
defined by the <TT
CLASS="PARAMETER"
><I
>path</I
></TT
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a double value to set.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN666"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-BOOL"
></A
>gnome_config_set_bool()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_set_bool(path,new_value)</PRE
></TD
></TR
></TABLE
><P
>Stores boolean value <TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
> in the file/section/key defined by
<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a boolean value to set</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN687"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-VECTOR"
></A
>gnome_config_set_vector()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_set_vector(path,argc,argv)</PRE
></TD
></TR
></TABLE
><P
>Stores vector <TT
CLASS="PARAMETER"
><I
>argv</I
></TT
> in the file/section/key defined by
<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the number of elements in <TT
CLASS="PARAMETER"
><I
>argv</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a string array holding the data to store.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN713"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-SET-STRING"
></A
>gnome_config_private_set_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_set_string(path,new_value)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN731"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-SET-TRANSLATED-STRING"
></A
>gnome_config_private_set_translated_string()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_set_translated_string(path,new_value)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN749"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-SET-INT"
></A
>gnome_config_private_set_int()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_set_int(path,new_value)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN767"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-SET-FLOAT"
></A
>gnome_config_private_set_float()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_set_float(path,new_value)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN785"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-SET-BOOL"
></A
>gnome_config_private_set_bool()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_set_bool(path,new_value)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN803"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-SET-VECTOR"
></A
>gnome_config_private_set_vector()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_set_vector(path,argc,argv)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN825"
></A
><H3
><A
NAME="GNOME-CONFIG-HAS-SECTION"
></A
>gnome_config_has_section()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_has_section(path)</PRE
></TD
></TR
></TABLE
><P
>Queries the gnome configuration file for the presence
of the section specified in <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to a section</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN841"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-HAS-SECTION"
></A
>gnome_config_private_has_section()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_has_section(path)</PRE
></TD
></TR
></TABLE
><P
>Queries the private gnome configuration file for the presence
of the section specified in <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path to a section</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN857"
></A
><H3
><A
NAME="GNOME-CONFIG-INIT-ITERATOR"
></A
>gnome_config_init_iterator()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_init_iterator(path)</PRE
></TD
></TR
></TABLE
><P
>Creates an iterator handle that can be used to
iterate over the keys in a section in a gnome configuration
file.  <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> must refer to a section.  The returned value
can be used as an iterator for #<A
HREF="gnome-gnome-config.html#GNOME-CONFIG-ITERATOR-NEXT"
>gnome_config_iterator_next</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path for a section.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN874"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-INIT-ITERATOR"
></A
>gnome_config_private_init_iterator()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_init_iterator(path)</PRE
></TD
></TR
></TABLE
><P
>Creates an iterator handle that can be used to
iterate over the keys in a section in a private gnome configuration
file.  <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> must refer to a section.  The returned value
can be used as an iterator for #<A
HREF="gnome-gnome-config.html#GNOME-CONFIG-ITERATOR-NEXT"
>gnome_config_iterator_next</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path for a section.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN891"
></A
><H3
><A
NAME="GNOME-CONFIG-INIT-ITERATOR-SECTIONS"
></A
>gnome_config_init_iterator_sections()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_init_iterator_sections(path)</PRE
></TD
></TR
></TABLE
><P
>Creates an iterator handle that can be used to iterate over the
sections in a gnome configuration file.  <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> must refer to a
gnome configuration file.  The returned value can be used as an
iterator for #<A
HREF="gnome-gnome-config.html#GNOME-CONFIG-ITERATOR-NEXT"
>gnome_config_iterator_next</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path for a file.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN908"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-INIT-ITERATOR-SECTIONS"
></A
>gnome_config_private_init_iterator_sections()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_init_iterator_sections(path)</PRE
></TD
></TR
></TABLE
><P
>Creates an iterator handle that can be used to iterate over the
sections in a private gnome configuration file.  <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> must refer to a
gnome configuration file.  The returned value can be used as an
iterator for #<A
HREF="gnome-gnome-config.html#GNOME-CONFIG-ITERATOR-NEXT"
>gnome_config_iterator_next</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configuration path for a file</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN925"
></A
><H3
><A
NAME="GNOME-CONFIG-ITERATOR-NEXT"
></A
>gnome_config_iterator_next ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void*       gnome_config_iterator_next      (void *iterator_handle,
                                             char **key,
                                             char **value);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iterator_handle</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome configu iterator handle, returned from any
iteration start routine or this routine.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>key</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Address where the key gets stored.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Address where the value gets stored.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN948"
></A
><H3
><A
NAME="GNOME-CONFIG-DROP-ALL"
></A
>gnome_config_drop_all ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_config_drop_all           (void);</PRE
></TD
></TR
></TABLE
><P
>Drops any information cached in memory that was fetched with
gnome config.  Any pending information that has not been
written to disk is discarded.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN954"
></A
><H3
><A
NAME="GNOME-CONFIG-SYNC"
></A
>gnome_config_sync ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_config_sync               (void);</PRE
></TD
></TR
></TABLE
><P
>Writes all of the information modified by gnome-config to the
disk.</P
><P
>Note: the gnome_config code does not write anything to the
configuration files until this routine is actually invoked.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN961"
></A
><H3
><A
NAME="GNOME-CONFIG-SYNC-FILE"
></A
>gnome_config_sync_file()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_sync_file(path)</PRE
></TD
></TR
></TABLE
><P
>Writes all of the information modified by gnome-config to the
disk for the given file.</P
><P
>Note: the gnome_config code does not write anything to the
configuration files until this routine or gnome_config_sync 
is actually invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome-config path</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN977"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-SYNC-FILE"
></A
>gnome_config_private_sync_file()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_sync_file(path)</PRE
></TD
></TR
></TABLE
><P
>Writes all of the information modified by gnome-config to the
disk for the given private file.</P
><P
>Note: the gnome_config code does not write anything to the
configuration files until this routine or gnome_config_sync 
is actually invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome-config path</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN993"
></A
><H3
><A
NAME="GNOME-CONFIG-DROP-FILE"
></A
>gnome_config_drop_file()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_drop_file(path)</PRE
></TD
></TR
></TABLE
><P
>Releases any memory resources that were allocated from accessing
the configuration file in <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.  Changes will take place after
<A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
> has been invoked</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome-config path</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1010"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-DROP-FILE"
></A
>gnome_config_private_drop_file()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_drop_file(path)</PRE
></TD
></TR
></TABLE
><P
>Releases any memory resources that were allocated from accessing the
private configuration file in <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome-config path</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1026"
></A
><H3
><A
NAME="GNOME-CONFIG-CLEAN-FILE"
></A
>gnome_config_clean_file()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_clean_file(path)</PRE
></TD
></TR
></TABLE
><P
>Cleans up the configuration file specified by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> from any
configuration information.</P
><P
>Changes will take place after <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
> has been invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome-config path</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1044"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-CLEAN-FILE"
></A
>gnome_config_private_clean_file()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_clean_file(path)</PRE
></TD
></TR
></TABLE
><P
>Cleans up the private configuration file specified by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> from
any configuration information.</P
><P
>Changes will take place after <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
> has been invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome-config path</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1062"
></A
><H3
><A
NAME="GNOME-CONFIG-CLEAN-SECTION"
></A
>gnome_config_clean_section()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_clean_section(path)</PRE
></TD
></TR
></TABLE
><P
>Cleans up the section specified by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> from any
configuration information.  Changes will only take place
after <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
> has been invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a section.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1079"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-CLEAN-SECTION"
></A
>gnome_config_private_clean_section()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_clean_section(path)</PRE
></TD
></TR
></TABLE
><P
>Cleans up the section specified by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> in a private file from any
configuration information.  Changes will only take place after
<A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
> has been invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a section.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1096"
></A
><H3
><A
NAME="GNOME-CONFIG-CLEAN-KEY"
></A
>gnome_config_clean_key()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_clean_key(path)</PRE
></TD
></TR
></TABLE
><P
>Removes the definition for the key on a gnome configuration file.</P
><P
>Changes will take place after <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
> has been invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1113"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-CLEAN-KEY"
></A
>gnome_config_private_clean_key()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_clean_key(path)</PRE
></TD
></TR
></TABLE
><P
>Removes the definition for the key on a private gnome configuration
file.</P
><P
>Changes will take place after <A
HREF="gnome-gnome-config.html#GNOME-CONFIG-SYNC"
>gnome_config_sync</A
> has been invoked.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path to a key.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1130"
></A
><H3
><A
NAME="GNOME-CONFIG-GET-REAL-PATH"
></A
>gnome_config_get_real_path()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_get_real_path(path)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1144"
></A
><H3
><A
NAME="GNOME-CONFIG-PRIVATE-GET-REAL-PATH"
></A
>gnome_config_private_get_real_path()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_config_private_get_real_path(path)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1158"
></A
><H3
><A
NAME="GNOME-CONFIG-PUSH-PREFIX"
></A
>gnome_config_push_prefix ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_config_push_prefix        (const char *path);</PRE
></TD
></TR
></TABLE
><P
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
> is a prefix that will be prepended automatically to any
non-absolute configuration path in gnome config.</P
><P
>This is used to simplify application loading code.</P
><P
>Library code will usually have to set the prefix before doing
any gnome-configuration access, since the application might
be using their own prefix.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome configuration path prefix</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1176"
></A
><H3
><A
NAME="GNOME-CONFIG-POP-PREFIX"
></A
>gnome_config_pop_prefix ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_config_pop_prefix         (void);</PRE
></TD
></TR
></TABLE
><P
>Call this routine to remove the current configuration prefix from the stack.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1182"
></A
><H3
><A
NAME="GNOME-CONFIG-MAKE-VECTOR"
></A
>gnome_config_make_vector ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_config_make_vector        (const char *string,
                                             int *argcp,
                                             char ***argvp);</PRE
></TD
></TR
></TABLE
><P
>Creates a new vector from a string as it stored in the config file,
breaks the string on spaces except if the space is escaped with a
backslash.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>string</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The stringified vector to decode into 'argcp' and 'argvp'</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argcp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns the number of elements in 'argvp'</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argvp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns the array of strings found in 'rr'.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1205"
></A
><H3
><A
NAME="GNOME-CONFIG-ASSEMBLE-VECTOR"
></A
>gnome_config_assemble_vector ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>char*       gnome_config_assemble_vector    (int argc,
                                             const char *const argv[]);</PRE
></TD
></TR
></TABLE
><P
>This routine returns the the strings in the array contactenated by
spaces.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of elements in the <TT
CLASS="PARAMETER"
><I
>argv</I
></TT
> string array.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An array of strings.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a <GTKDOCLINK
HREF="G-MALLOC"
>g_malloc</GTKDOCLINK
>()ed string with the concatenation results.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1230"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-SET-HANDLER"
></A
>gnome_config_set_set_handler ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_config_set_set_handler    (void (*func) (void *),
                                             void *data);</PRE
></TD
></TR
></TABLE
><P
>Internal Obsolete.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Obsolete</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Obsolete</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1249"
></A
><H3
><A
NAME="GNOME-CONFIG-SET-SYNC-HANDLER"
></A
>gnome_config_set_sync_handler ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_config_set_sync_handler   (void (*func) (void *),
                                             void *data);</PRE
></TD
></TR
></TABLE
><P
>Internal routine</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> obsolete</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> obsolete</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-gnome-defs.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Gnome Library</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-defs</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>