Re: api doc patch



arg, actually the first patch was incomplete, here is another one


Le dim 28/07/2002 à 12:56, Christophe Fergeau a écrit :
> Hi,
> 
> Here is a patch which documents some functions from gconf_engine and
> gconf_client. To document gconf_client functions, I mostly did cut and
> paste from the equivalent gconf_engine functions. With that patch,
> gconf_client, which should be the most used part of GConf is nearly 100%
> documented. 
> These docs need reviewing since I wrote the docs for the
> gconf_engine_set_* and gconf_client_set_* functions from scratch and my
> english and understanding of GConf aren't perfect :)
> That leads me to another question : does anybody on this list know if
> there are people in charge of the api docs, and of the api part of
> developer.gnome.org ?
> 
> Cheers, 
> 
> Christophe
> 
> 
> 
> ----
> 

> ? api.diff
> ? backends/xml-test
> ? doc/gconf/api.diff
> ? doc/gconf/gconf-docs.sgml
> ? gconf/gconf-sanity-check-2
> ? po/Makefile.in.in
> Index: doc/gconf/tmpl/gconf-client.sgml
> ===================================================================
> RCS file: /cvs/gnome/gconf/doc/gconf/tmpl/gconf-client.sgml,v
> retrieving revision 1.12
> diff -u -d -b -u -r1.12 gconf-client.sgml
> --- doc/gconf/tmpl/gconf-client.sgml	3 Jan 2002 20:15:42 -0000	1.12
> +++ doc/gconf/tmpl/gconf-client.sgml	28 Jul 2002 10:52:10 -0000
> @@ -356,86 +356,112 @@
>  
>  <!-- ##### FUNCTION gconf_client_get ##### -->
>  <para>
> -
> +Gets the value of a configuration key. Just like gconf_engine_get (), but uses
> +#GConfClient caching and error-handling features.
>  </para>
>  
> - client: 
> - key: 
> - err: 
> - Returns: 
> + client: a #GConfClient.
> + key: key to get.
> + err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> + Returns: newly-allocated #GConfValue, or <symbol>NULL</symbol> if unset and no default exists.
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_without_default ##### -->
>  <para>
> -
> +Gets the value of a configuration key. Just like gconf_client_get () but doesn't look for a default value if the key is unset.
>  </para>
>  
> - client: 
> - key: 
> - err: 
> - Returns: 
> + client: a #GConfClient.
> + key: key to get.
> + err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> + Returns: newly-allocated #GConfValue, or <symbol>NULL</symbol> if unset (even if a default exists).
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_entry ##### -->
>  <para>
> -
> +Obtains the full #GConfEntry for a value. Just like gconf_engine_get_entry (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
> - client: 
> - key: 
> - locale: 
> - use_schema_default: 
> - err: 
> + client: a #GConfClient.
> + key:  key to get.
> + locale: preferred locale (as in the locale-related environment variables).
> + use_schema_default: indicates whether to look for a default value when the key is unset.
> + err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
>  @Returns: 
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_default_from_schema ##### -->
>  <para>
> -
> +Returns the default value stored in the key's schema, if the key has a schema
> +associated and the schema exists and the schema contains a default value.  Note
> +that gconf_client_get (), gconf_engine_client_string(), and so on already return the default value
> +if no other value is found, so normally you do not need this function. This
> +function is just for convenience; you could also get the #GConfMetaInfo for the
> +key, read the schema name from there, then look up the schema by name and
> +extract the default value. Just like gconf_engine_get_default_from_schema (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
> - client: 
> - key: 
> - err: 
> - Returns: 
> + client: a #GConfClient.
> + key: key to get.
> + err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> + Returns: newly-allocated #GConfValue, or <symbol>NULL</symbol> if the key has no default value in its schema.
>  
>  
>  <!-- ##### FUNCTION gconf_client_unset ##### -->
>  <para>
> -
> +Unsets the value of @key; if @key is already unset, has no effect.  An
> +error of note is %GCONF_OVERRIDDEN, indicating that the system
> +administrator has "forced" a value for this key. 
> +Just like gconf_engine_unset (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> + key: key to unset.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_all_entries ##### -->
>  <para>
> -
> +Lists the key-value pairs in @dir. Does not list subdirectories; for
> +that use gconf_client_all_dirs(). The returned list contains #GConfEntry
> +objects. A #GConfEntry contains a <emphasis>relative</emphasis> key
> +and a value. The list is not recursive, it contains only the immediate
> +children of @dir.  To free the returned list, gconf_entry_free()
> +each list element, then g_slist_free() the list itself.
> +Just like gconf_engine_all_entries (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - dir: 
> + dir: directory to list.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: List of #GConfEntry.
>  
>  
>  <!-- ##### FUNCTION gconf_client_all_dirs ##### -->
>  <para>
> -
> +Lists the subdirectories in @dir. The returned list contains allocated
> +strings; you should g_free() each string in the list, then
> +g_slist_free() the list itself.
> +Just like gconf_engine_all_dirs (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - dir: 
> + dir: directory to get subdirectories from.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: List of allocated subdirectory names.
>  
>  
>  <!-- ##### FUNCTION gconf_client_suggest_sync ##### -->
>  <para>
> -
> +Suggests to <application>gconfd</application> that you've just finished
> +a block of changes, and it would be an optimal time to sync to
> +permanent storage. This is only a suggestion; and
> +<application>gconfd</application> will eventually sync even if you
> +don't call gconf_engine_suggest_sync(). This function is just a "hint"
> +provided to <application>gconfd</application> to maximize efficiency
> +and minimize data loss.
> +Just like gconf_engine_suggest_sync ().
>  </para>
>  
>  @client: a #GConfClient.
> @@ -444,155 +470,331 @@
>  
>  <!-- ##### FUNCTION gconf_client_dir_exists ##### -->
>  <para>
> -
> +Queries whether the directory @dir exists in the GConf
> +database. Returns <symbol>TRUE</symbol> or <symbol>FALSE</symbol>.
> +Just like gconf_engine_dir_exists (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - dir: 
> + dir: directory to check for
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> or <symbol>FALSE</symbol>.
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_float ##### -->
>  <para>
> -
> +Requests the floating point number (%GCONF_VALUE_FLOAT) stored at
> + key  Automatically performs type-checking, so if a non-float is
> +stored at @key, an error is returned. On error, or if @key is unset, 
> +0.0 is returned.
> +Just like gconf_engine_get_float (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> + key: key you want the value of.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: the value of @key, or 0.0 if no value is obtained.
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_int ##### -->
>  <para>
> -
> +Requests the integer (%GCONF_VALUE_INT) stored at
> + key  Automatically performs type-checking, so if a non-integer is
> +stored at @key, an error is returned. On error, or if @key is unset, 
> +0 is returned.
> +Just like gconf_engine_get_int (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> + key: key you want the value of.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: the value of @key, or 0 if no value is obtained.
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_string ##### -->
>  <para>
> -
> +Requests the string (%GCONF_VALUE_STRING) stored at
> + key  Automatically performs type-checking, so if a non-string is
> +stored at @key, an error is returned. On error, or if @key is unset, 
> +<symbol>NULL</symbol> is returned.
> +Just like gconf_engine_get_string (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> + key: key you want the value of.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: allocated string (value of @key), or <symbol>NULL</symbol> if no value is obtained.
> +
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_bool ##### -->
>  <para>
> -
> +Requests the boolean value (%GCONF_VALUE_BOOL) stored at
> + key  Automatically performs type-checking, so if a non-bool is
> +stored at @key, an error is returned. On error, or if @key is unset, 
> +<symbol>FALSE</symbol> is returned.
> +Just like gconf_engine_get_bool (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> + key: key you want the value of.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: the value of @key, or <symbol>FALSE</symbol> if no value is obtained.
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_schema ##### -->
>  <para>
> -
> +Requests the schema (%GCONF_VALUE_SCHEMA) stored at @key.
> +Automatically performs type-checking, so if a non-schema is stored at
> + key, an error is returned. If no value is set or an error occurs,
> +<symbol>NULL</symbol> is returned.
> +Just like gconf_engine_get_schema (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> + key: key you want the value of.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: the value of @key as an allocated #GConfSchema, or <symbol>NULL</symbol> if no value was obtained.
> +
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_list ##### -->
>  <para>
> +Requests the list (%GCONF_VALUE_LIST) stored at @key.  Automatically
> +performs type-checking, so if a non-list is stored at @key, or the
> +list does not contain elements of type @list_type, an error is
> +returned. If no value is set or an error occurs, <symbol>NULL</symbol>
> +is returned. Note that <symbol>NULL</symbol> is also the empty list,
> +so if you need to distinguish the empty list from an unset value, you
> +must use gconf_client_get () to obtain a raw #GConfValue.
> +</para>
> +
> +<para>
> +<emphasis>Remember that GConf lists can only store primitive types:
> +%GCONF_VALUE_FLOAT, %GCONF_VALUE_INT, %GCONF_VALUE_BOOL,
> +%GCONF_VALUE_STRING, %GCONF_VALUE_SCHEMA.</emphasis> Also remember
> +that lists must be uniform, you may not mix types in the same list.
> +</para>
> +
> +<para>
> +The type of the list elements depends on @list_type. A #GConfValue
> +with type %GCONF_VALUE_LIST normally stores a list of more #GConfValue
> +objects. gconf_client_get_list() automatically converts to primitive C
> +types. Thus, the list-&gt;data fields in the returned list 
> +contain:
> + 
> +<informaltable pgwide=1 frame="none">
> +<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
> +<tbody>
> +
> +<row>
> +<entry>%GCONF_VALUE_INT</entry>
> +<entry>The integer itself, converted with GINT_TO_POINTER()</entry>
> +</row>
> +
> +<row>
> +<entry>%GCONF_VALUE_BOOL</entry>
> +<entry>The bool itself, converted with GINT_TO_POINTER()</entry>
> +</row>
> +
> +<row>
> +<entry>%GCONF_VALUE_FLOAT</entry>
> +<entry>A pointer to #gdouble, which should be freed with g_free()</entry>
> +</row>
>  
> +<row>
> +<entry>%GCONF_VALUE_STRING</entry>
> +<entry>A pointer to #gchar, which should be freed with g_free()</entry>
> +</row>
> +
> +<row>
> +<entry>%GCONF_VALUE_SCHEMA</entry>
> +<entry>A pointer to #GConfSchema, which should be freed with gconf_schema_free()</entry>
> +</row>
> +
> +</tbody></tgroup></informaltable>
> +
> +In the %GCONF_VALUE_FLOAT and %GCONF_VALUE_STRING cases, you must
> +g_free() each list element. In the %GCONF_VALUE_SCHEMA case you must
> +gconf_schema_free() each element. In all cases you must free the
> +list itself with g_slist_free().
> +
> +Just like gconf_engine_get_list (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - list_type: 
> + key: key you want the value of.
> + list_type: type of each list element.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: an allocated list, with elements as described above.
>  
>  
>  <!-- ##### FUNCTION gconf_client_get_pair ##### -->
>  <para>
> +Requests the pair (%GCONF_VALUE_PAIR) stored at @key.  Automatically
> +performs type-checking, so if a non-pair is stored at @key, or the
> +pair does not have the right @car_type and @cdr_type, an error is
> +returned. Remember that the <firstterm>car</firstterm> of a pair is
> +its first value, and the <firstterm>cdr</firstterm> is its second
> +value, in the Lisp tradition. 
> +</para>
> +
> +<para>
> +<emphasis>Remember that GConf pairs can only store primitive types:
> +%GCONF_VALUE_FLOAT, %GCONF_VALUE_INT, %GCONF_VALUE_BOOL,
> +%GCONF_VALUE_STRING, %GCONF_VALUE_SCHEMA.</emphasis>
> +</para>
> +
> +<para>
> +gconf_client_get_pair() stores the two fields of the pair in the locations
> +pointed to by @car_retloc and @cdr_retloc. The type of these pointers
> +depends on the corresponding @car_type and @cdr_type:
> + 
> +<informaltable pgwide=1 frame="none">
> +<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
> +<tbody>
> +
> +<row>
> +<entry>%GCONF_VALUE_INT</entry>
> +<entry>pointer to #gint</entry>
> +</row>
> +
> +<row>
> +<entry>%GCONF_VALUE_BOOL</entry>
> +<entry>pointer to #gboolean</entry>
> +</row>
> +
> +<row>
> +<entry>%GCONF_VALUE_FLOAT</entry>
> +<entry>pointer to #gdouble</entry>
> +</row>
> +
> +<row>
> +<entry>%GCONF_VALUE_STRING</entry>
> +<entry>pointer to #gchar*</entry>
> +</row>
> +
> +<row>
> +<entry>%GCONF_VALUE_SCHEMA</entry>
> +<entry>pointer to #GConfSchema*</entry>
> +</row>
> +
> +</tbody></tgroup></informaltable>
> +
> +In the %GCONF_VALUE_STRING case, you must g_free() the string(s)
> +stored in the return location(s). In the %GCONF_VALUE_SCHEMA case you
> +must gconf_schema_free() the returned schema. If there's an error
> +or the value is unset, @car_retloc and @cdr_retloc are left unchanged.
> +</para>
> +
> +<para>
> +gconf_client_get_pair() returns <symbol>TRUE</symbol> on success.
> +</para>
> +
> +<para>
> +An example of gconf_client_get_pair() in action:
> +<programlisting>
> +gdouble car = 10.0;
> +gchar* cdr  = NULL; 
> +GError* error = NULL;
> +
> +if (!gconf_client_get_pair(conf, "/foo", 
> +                    GCONF_VALUE_FLOAT,
> +                    GCONF_VALUE_STRING, 
> +                    &amp;car, &amp;cdr, &amp;error))
> +  {
> +    /* Note: car/cdr should be untouched, because an error occurred */
> +    g_assert(error != NULL);
> +    fprintf(stderr, "Error: %s\n", error->message);
> +    g_error_free(error);
> +    error = NULL;
> +  }
> +else
> +  {
> +    /* Note: car/cdr may be untouched even though there was no error, 
> +       if no value was set for "/foo"
> +     */
> +    printf("Found pair (%g,%s)\n", car, cdr);
> +    if (cdr != NULL)
> +      g_free(cdr);
> +  }
> +</programlisting>
>  
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - car_type: 
> - cdr_type: 
> - car_retloc: 
> - cdr_retloc: 
> + key: key you want the value of.
> + car_type: desired type of the pair's first field (car).
> + cdr_type: desired type of the pair's second field (cdr).
> + car_retloc: address of a return location for the car.
> + cdr_retloc: address of a return location for the cdr.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_set_float ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a float (GCONF_VALUE_FLOAT), gconf_client_set_float() will fail.
> +Just like gconf_engine_set (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_set_int ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store an integer (GCONF_VALUE_INT), gconf_client_set_int() will fail.
> +Just like gconf_engine_set (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_set_string ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a string (GCONF_VALUE_STRING), gconf_client_set_string() will fail.
> +Just like gconf_engine_set (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_set_bool ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but but doesn't store a boolean (GCONF_VALUE_BOOL), gconf_client_set_bool() will fail.
> +Just like gconf_engine_set (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_set_schema ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a schema value (GCONF_VALUE_SCHEMA), gconf_client_set_schema() will fail.
> +Just like gconf_engine_set (), but uses #GConfClient caching and error-handling features.
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_set_list ##### -->
> @@ -601,11 +803,11 @@
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - list_type: 
> - list: 
> + key: key you want to set the value of.
> + list_type: type of each list element.
> + list: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_set_pair ##### -->
> @@ -614,13 +816,13 @@
>  </para>
>  
>  @client: a #GConfClient.
> - key: 
> - car_type: 
> - cdr_type: 
> - address_of_car: 
> - address_of_cdr: 
> + key: key you want to set the value of.
> + car_type: type of the pair's first field (car).
> + cdr_type: type of the pair's second field (cdr).
> + address_of_car: address of the car.
> + address_of_cdr: address of the cdr.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_client_error ##### -->
> Index: doc/gconf/tmpl/gconf.sgml
> ===================================================================
> RCS file: /cvs/gnome/gconf/doc/gconf/tmpl/gconf.sgml,v
> retrieving revision 1.14
> diff -u -d -b -u -r1.14 gconf.sgml
> --- doc/gconf/tmpl/gconf.sgml	17 Sep 2000 00:55:00 -0000	1.14
> +++ doc/gconf/tmpl/gconf.sgml	28 Jul 2002 10:52:10 -0000
> @@ -578,62 +578,62 @@
>  
>  <!-- ##### FUNCTION gconf_engine_set_float ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a float (GCONF_VALUE_FLOAT), gconf_engine_set_float() will fail.
>  </para>
>  
>  @conf: a #GConfEngine.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_engine_set_int ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store an integer (GCONF_VALUE_INT), gconf_engine_set_int() will fail.
>  </para>
>  
>  @conf: a #GConfEngine.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_engine_set_string ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a string (GCONF_VALUE_STRING), gconf_engine_set_string() will fail.
>  </para>
>  
>  @conf: a #GConfEngine.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_engine_set_bool ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but but doesn't store a boolean (GCONF_VALUE_BOOL), gconf_engine_set_bool() will fail.
>  </para>
>  
>  @conf: a #GConfEngine.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_engine_set_schema ##### -->
>  <para>
> -
> +Change the value of @key to @val. Automatically creates the @key if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a schema value (GCONF_VALUE_SCHEMA), gconf_engine_set_schema() will fail.
>  </para>
>  
>  @conf: a #GConfEngine.
> - key: 
> - val: 
> + key: key you want to set the value of.
> + val: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_engine_set_list ##### -->
> @@ -642,11 +642,11 @@
>  </para>
>  
>  @conf: a #GConfEngine.
> - key: 
> - list_type: 
> - list: 
> + key: key you want to set the value of.
> + list_type: type of each list element.
> + list: new value of @key.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### FUNCTION gconf_engine_set_pair ##### -->
> @@ -655,13 +655,15 @@
>  </para>
>  
>  @conf: a #GConfEngine.
> - key: 
> - car_type: 
> - cdr_type: 
> + key: key you want to set the value of.
> + car_type: type of the pair's first field (car).
> + cdr_type: type of the pair's second field (cdr).
>  @address_of_car: 
>  @address_of_cdr: 
> + car_retloc: address of the car.
> + cdr_retloc: address of the cdr.
>  @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
> - Returns: 
> + Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
>  
>  
>  <!-- ##### STRUCT GConfEnumStringPair ##### -->

Attachment: api.diff.bz2
Description: application/bzip



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]