Index: gconf/gconf.c
===================================================================
RCS file: /export/cvs/head/gconf/gconf/gconf.c,v
retrieving revision 1.148
diff -p -u -5 -r1.148 gconf.c
--- gconf/gconf.c	14 Jul 2005 17:30:49 -0000	1.148
+++ gconf/gconf.c	23 Sep 2005 13:41:53 -0000
@@ -2293,11 +2293,13 @@ gconf_detach_config_server(void)
 /**
  * gconf_debug_shutdown:
  * @void: 
  * 
  * Detach from the config server and release
- * all related resources
+ * all related resources.
+ *
+ * Returns: 1 if an exception occurs, 0 otherwise.
  **/
 int
 gconf_debug_shutdown (void)
 {
   gconf_detach_config_server ();
Index: doc/gconf/gconf-sections.txt
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/gconf-sections.txt,v
retrieving revision 1.17
diff -p -u -5 -r1.17 gconf-sections.txt
--- doc/gconf/gconf-sections.txt	17 Sep 2000 00:55:00 -0000	1.17
+++ doc/gconf/gconf-sections.txt	23 Sep 2005 13:42:05 -0000
@@ -11,20 +11,22 @@ gconf_client_get_default
 gconf_client_get_for_engine
 gconf_client_add_dir
 gconf_client_remove_dir
 gconf_client_notify_add
 gconf_client_notify_remove
+gconf_client_notify
 gconf_client_set_error_handling
 gconf_client_set_global_default_error_handler
 gconf_client_clear_cache
 gconf_client_preload
 gconf_client_set
 gconf_client_get
 gconf_client_get_without_default
 gconf_client_get_entry
 gconf_client_get_default_from_schema
 gconf_client_unset
+gconf_client_recursive_unset
 gconf_client_all_entries
 gconf_client_all_dirs
 gconf_client_suggest_sync
 gconf_client_dir_exists
 gconf_client_get_float
@@ -46,10 +48,11 @@ gconf_client_unreturned_error
 gconf_client_value_changed
 gconf_client_reverse_change_set
 gconf_client_change_set_from_currentv
 gconf_client_change_set_from_current
 gconf_client_commit_change_set
+gconf_client_key_is_writable
 <SUBSECTION Standard>
 GCONF_TYPE_CLIENT
 GCONF_IS_CLIENT
 gconf_client_get_type
 GCONF_CLIENT_CLASS
@@ -72,19 +75,26 @@ gconf_backend_resolve_address
 <SECTION>
 <FILE>gconf-engine</FILE>
 GConfEngine
 gconf_engine_get_default
 gconf_engine_get_for_address
+gconf_engine_get_for_addresses
+gconf_engine_get_local_for_addresses
 gconf_engine_get_local
 gconf_engine_unref
 gconf_engine_ref
+gconf_engine_get_user_data
+gconf_engine_set_user_data
+gconf_engine_key_is_writable
+gconf_engine_remove_dir
 </SECTION>
 
 <SECTION>
 <FILE>gconf-error</FILE>
 GConfError
 gconf_error_new
+gconf_error_quark
 gconf_set_error
 gconf_compose_errors
 </SECTION>
 
 <SECTION>
@@ -136,10 +146,13 @@ GConfListeners
 GConfListenersCallback
 gconf_listeners_new
 gconf_listeners_free
 gconf_listeners_add
 gconf_listeners_remove
+gconf_listeners_foreach
+gconf_listeners_get_data
+gconf_listeners_remove_if
 gconf_listeners_notify
 gconf_listeners_count
 </SECTION>
 
 <SECTION>
@@ -232,14 +245,21 @@ gconf_meta_info_mod_time
 gconf_meta_info_set_schema
 gconf_meta_info_set_mod_user
 gconf_meta_info_set_mod_time
 GConfEntry
 gconf_entry_new_nocopy
+gconf_entry_new
+gconf_entry_ref
+gconf_entry_unref
 gconf_entry_free
+gconf_entry_copy
 gconf_entry_get_key
 gconf_entry_get_value
 gconf_entry_steal_value
+gconf_entry_get_is_writable
+gconf_entry_set_is_writable
+gconf_entry_set_value
 gconf_entry_get_is_default
 gconf_entry_get_schema_name
 gconf_entry_set_is_default
 gconf_entry_set_schema_name
 gconf_entry_set_value_nocopy
@@ -266,10 +286,16 @@ gconf_engine_all_entries
 gconf_engine_all_dirs
 gconf_engine_suggest_sync
 gconf_engine_dir_exists
 gconf_valid_key
 gconf_key_is_below
+gconf_escape_key
+gconf_unescape_key
+gconf_unique_key
+gconf_synchronous_sync
+gconf_debug_shutdown
+gconf_clear_cache
 gconf_engine_get_float
 gconf_engine_get_int
 gconf_engine_get_string
 gconf_engine_get_bool
 gconf_engine_get_schema
@@ -307,10 +333,12 @@ GConfChangeSetForeachFunc
 gconf_engine_commit_change_set
 gconf_change_set_new
 gconf_change_set_ref
 gconf_change_set_unref
 gconf_change_set_clear
+gconf_change_set_get_user_data
+gconf_change_set_set_user_data
 gconf_change_set_size
 gconf_change_set_remove
 gconf_change_set_foreach
 gconf_change_set_set
 gconf_change_set_set_nocopy
Index: doc/gconf/tmpl/gconf-client.sgml
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/tmpl/gconf-client.sgml,v
retrieving revision 1.17
diff -p -u -5 -r1.17 gconf-client.sgml
--- doc/gconf/tmpl/gconf-client.sgml	25 Jul 2005 16:12:58 -0000	1.17
+++ doc/gconf/tmpl/gconf-client.sgml	23 Sep 2005 13:42:12 -0000
@@ -302,10 +302,22 @@ notification's user data, if appropriate
 
 @client: a #GConfClient.
 @cnxn: connection ID.
 
 
+<!-- ##### FUNCTION gconf_client_notify ##### -->
+<para>
+Obtains the #GConfEntry associated with the #GConfClient using gconf_client_get_entry().
+If the entry is not <symbol>NULL </symbol> it emits the value_changed signal by calling
+gconf_client_value_changed() and notifies the listeners associated with the client,if any.
+</para>
+
+@client: a #GConfClient.
+@key: the key that has changed.
+@Since: 2.4.
+
+
 <!-- ##### FUNCTION gconf_client_set_error_handling ##### -->
 <para>
 Controls the default error handling for #GConfClient. See
 #GConfClientErrorHandlingMode and #GConfClientParentWindowFunc for details on this.
 </para>
@@ -426,10 +438,25 @@ Just like gconf_engine_unset (), but use
 @key: key to unset.
 @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
 @Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
 
 
+<!-- ##### FUNCTION gconf_client_recursive_unset ##### -->
+<para>
+Unsets all keys below @key, including @key itself.  If any unset fails, continues on to unset 
+as much as it can. The first failure is returned in @err. Just like gconf_engine_recursive_unset (), 
+but uses #GConfClient caching and error-handling features.
+</para>
+
+@client: a #GConfClient.
+@key: a key or directory name to be unset.
+@flags: change how the unset is done.
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+@Returns: <symbol>TRUE</symbol> on success, <symbol>FALSE</symbol> on error.
+@Since: 2.4.
+
+
 <!-- ##### 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 an <emphasis>absolute</emphasis> key
@@ -905,5 +932,16 @@ Convenient varargs version of gconf_clie
 @remove_committed: 
 @err: 
 @Returns: 
 
 
+<!-- ##### FUNCTION gconf_client_key_is_writable ##### -->
+<para>
+Checks whether the key is writable.
+</para>
+
+@client: a #GConfClient.
+@key: the value to be changed
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+@Returns: <symbol>TRUE</symbol> if the key is writable, <symbol>FALSE</symbol> if the key is read only.
+
+
Index: doc/gconf/tmpl/gconf-changeset.sgml
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/tmpl/gconf-changeset.sgml,v
retrieving revision 1.8
diff -p -u -5 -r1.8 gconf-changeset.sgml
--- doc/gconf/tmpl/gconf-changeset.sgml	25 Jul 2005 16:12:58 -0000	1.8
+++ doc/gconf/tmpl/gconf-changeset.sgml	23 Sep 2005 13:42:22 -0000
@@ -114,10 +114,30 @@ change set would have no effect.
 </para>
 
 @cs: a #GConfChangeSet.
 
 
+<!-- ##### FUNCTION gconf_change_set_get_user_data ##### -->
+<para>
+Returns the user_data field of the #GConfChangeSet.
+</para>
+
+@cs: a #GConfChangeSet.
+@Returns: a pointer to the user_data.
+
+
+<!-- ##### FUNCTION gconf_change_set_set_user_data ##### -->
+<para>
+Sets the user_data and the destroy notification function fields of the 
+#GConfChangeSet.
+</para>
+
+@cs: a #GConfChangeSet.
+@data: a #gpointer.
+@dnotify: a pointer to the function to be called during destroy.
+
+
 <!-- ##### FUNCTION gconf_change_set_size ##### -->
 <para>
 
 </para>
 
Index: doc/gconf/tmpl/gconf-engine.sgml
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/tmpl/gconf-engine.sgml,v
retrieving revision 1.10
diff -p -u -5 -r1.10 gconf-engine.sgml
--- doc/gconf/tmpl/gconf-engine.sgml	25 Jul 2005 16:12:58 -0000	1.10
+++ doc/gconf/tmpl/gconf-engine.sgml	23 Sep 2005 13:42:30 -0000
@@ -59,21 +59,46 @@ unreferenced by the caller of this funct
 @address: a configuration source address.
 @err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
 @Returns: a #GConfEngine.
 
 
+<!-- ##### FUNCTION gconf_engine_get_for_addresses ##### -->
+<para>
+Similar to gconf_engine_get_for_address() , but takes a list of addresses 
+instead of a single address.
+</para>
+
+@addresses: a list of configuration addresses.
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+@Returns: a #GConfEngine.
+@Since: 2.4
+
+
+<!-- ##### FUNCTION gconf_engine_get_local_for_addresses ##### -->
+<para>
+Obtains a local #GConfEngine similar to gconf_engine_get_local ().
+Instead of taking the address of the local database, this function takes
+the addresses of the sources and gets the #GConfSources using gconf_sources_new_from_addresses ().
+</para>
+
+@addresses: a list of addresses of #GConfSources.
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+@Returns: a #GConfEngine.
+@Since: 2.8
+
+
 <!-- ##### FUNCTION gconf_engine_get_local ##### -->
 <para>
 Obtain a local (non-process-transparent) #GConfEngine. Local engines
 do not support notification, and can only access config databases
 directly (they do not use the multiple sources in a path system
 supported by nonlocal engines).
 </para>
 
 @address: address of local database
 @err: return location of an allocated #GError
-@Returns: a #GConfEngine
+@Returns: a #GConfEngine.
 
 
 <!-- ##### FUNCTION gconf_engine_unref ##### -->
 <para>
 Decreases the reference count of a #GConfEngine by one; if the
@@ -89,5 +114,48 @@ Increases the reference count of a #GCon
 </para>
 
 @conf: a #GConfEngine.
 
 
+<!-- ##### FUNCTION gconf_engine_get_user_data ##### -->
+<para>
+Returns the user_data field of a #GConfEngine.
+</para>
+
+@engine: a #GConfEngine.
+@Returns: a pointer to the user_data
+
+
+<!-- ##### FUNCTION gconf_engine_set_user_data ##### -->
+<para>
+Sets the user_data and the destroy notification function fields of a #GConfEngine.
+</para>
+
+@engine: a #GConfEngine.
+@data: a #gpointer
+@dnotify: a pointer to the function to be called during destroy.
+
+
+<!-- ##### FUNCTION gconf_engine_key_is_writable ##### -->
+<para>
+Checks whether the key is writable. 
+</para>
+
+@conf: a #GConfEngine.
+@key: the value to be changed
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+@Returns: <symbol>TRUE</symbol> if the key is writable, <symbol>FALSE</symbol> if the key is read only.
+
+
+<!-- ##### FUNCTION gconf_engine_remove_dir ##### -->
+<para>
+This function first checks the validity of the gconf key. In case of a local #GConfEngine it removes
+the directory from the source backend calling gconf_sources_remove_dir (). Otherwise it obtains the 
+configuration database using gconf_engine_get_database () and removes the directory from the database
+calling ConfigDatabase_remove_dir ().
+</para>
+
+@conf: a #GConfEngine.
+@dir: the name of the directory to be removed.
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+
+
Index: doc/gconf/tmpl/gconf-error.sgml
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/tmpl/gconf-error.sgml,v
retrieving revision 1.10
diff -p -u -5 -r1.10 gconf-error.sgml
--- doc/gconf/tmpl/gconf-error.sgml	25 Jul 2005 16:12:58 -0000	1.10
+++ doc/gconf/tmpl/gconf-error.sgml	23 Sep 2005 13:42:38 -0000
@@ -115,10 +115,18 @@ argument list is the same as in printf()
 @format: printf()-style format for error description.
 @Varargs: arguments required by the @format.
 @Returns: newly-allocated #GError.
 
 
+<!-- ##### FUNCTION gconf_error_quark ##### -->
+<para>
+Converts the string 'gconf-error-quark' to a #GQuark and returns the value.
+</para>
+
+@Returns: the #GQuark representing the string.
+
+
 <!-- ##### FUNCTION gconf_set_error ##### -->
 <para>
 Internal function.
 </para>
 
Index: doc/gconf/tmpl/gconf-listeners.sgml
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/tmpl/gconf-listeners.sgml,v
retrieving revision 1.4
diff -p -u -5 -r1.4 gconf-listeners.sgml
--- doc/gconf/tmpl/gconf-listeners.sgml	25 Jul 2005 16:12:58 -0000	1.4
+++ doc/gconf/tmpl/gconf-listeners.sgml	23 Sep 2005 13:42:47 -0000
@@ -70,10 +70,43 @@ gconf-listeners
 
 @listeners: 
 @cnxn_id: 
 
 
+<!-- ##### FUNCTION gconf_listeners_foreach ##### -->
+<para>
+Execute a function for each of the #GConfListeners.
+</para>
+
+@listeners: a #GConfListeners.
+@callback: the function to be called.
+@user_data: a gpointer.
+
+
+<!-- ##### FUNCTION gconf_listeners_get_data ##### -->
+<para>
+Obtains the data particular to a #GConfListener.
+</para>
+
+@listeners: a #GConfListeners.
+@cnxn_id: the connection id, an integer.
+@listener_data_p: the address for getting the listener data.
+@location_p: a pointer to the address for getting the name.
+@Returns: <symbol>TRUE</symbol> if the data could be obtained successfully, <symbol>FALSE</symbol> 
+if an error occurs while retrieving the data.
+
+
+<!-- ##### FUNCTION gconf_listeners_remove_if ##### -->
+<para>
+Remove the listener if a predicate is satisfied.
+</para>
+
+@listeners: a #GConfListeners.
+@predicate: the predicate checked for removal.
+@user_data: a gpointer.
+
+
 <!-- ##### FUNCTION gconf_listeners_notify ##### -->
 <para>
 
 </para>
 
Index: doc/gconf/tmpl/gconf.sgml
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/tmpl/gconf.sgml,v
retrieving revision 1.19
diff -p -u -5 -r1.19 gconf.sgml
--- doc/gconf/tmpl/gconf.sgml	25 Jul 2005 16:12:58 -0000	1.19
+++ doc/gconf/tmpl/gconf.sgml	23 Sep 2005 13:43:06 -0000
@@ -334,10 +334,41 @@ it internally so here it is if you need 
 @above: the key on the "left hand side" of the predicate.
 @below: the key on the "right hand side."
 @Returns: <symbol>TRUE</symbol> or <symbol>FALSE</symbol>.
 
 
+<!-- ##### FUNCTION gconf_unique_key ##### -->
+<para>
+Generates a new and unique key using serial number, process id, current time and a 
+random number generated.
+</para>
+
+@Returns: a newly created key, a gchar value.
+
+
+<!-- ##### FUNCTION gconf_synchronous_sync ##### -->
+<para>
+In case of a local #GConfEngine, this function syncs up all the gconf sources calling
+gconf_synchronous_sync (). Otherwise it obtains the configuration database using
+gconf_engine_get_database () and syncs up the database calling ConfigDatabase_synchronous_sync ().
+</para>
+
+@conf: a #GConfEngine.
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+
+
+<!-- ##### FUNCTION gconf_clear_cache ##### -->
+<para>
+In case of a local #GConfEngine, this function calls gconf_sources_clear_cache () to clear the
+cache from the source. Otherwise it obtains the configuration database using gconf_engine_get_database ()
+and clears the configuration database cache using ConfigDatabase_clear_cache ().
+</para>
+
+@conf: a #GConfEngine.
+@err: the return location for an allocated #GError, or <symbol>NULL</symbol> to ignore errors.
+
+
 <!-- ##### FUNCTION gconf_engine_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, 
Index: doc/gconf/tmpl/gconf-value.sgml
===================================================================
RCS file: /export/cvs/head/gconf/doc/gconf/tmpl/gconf-value.sgml,v
retrieving revision 1.22
diff -p -u -5 -r1.22 gconf-value.sgml
--- doc/gconf/tmpl/gconf-value.sgml	25 Jul 2005 16:12:58 -0000	1.22
+++ doc/gconf/tmpl/gconf-value.sgml	23 Sep 2005 13:43:15 -0000
@@ -509,11 +509,11 @@ value, use gconf_entry_get_key() and gco
 
 <warning><para>Value can be <symbol>NULL</symbol>, indicating that the
 value is not set.</para></warning>
 
 @key: an absolute key name
-@value: 
+@value: the value 
 
 <!-- ##### FUNCTION gconf_entry_new_nocopy ##### -->
 <para>
 Creates a new #GConfEntry with key @key and value @val. @key should be a full
 path to the key, starting with '/'. Neither the key nor the value is copied;
@@ -521,21 +521,57 @@ both are freed when the #GConfEntry is f
 g_free() so should be allocated with a GLib function, not malloc().
 </para>
 
 @key: the key name
 @val: the value
-@Returns: a new #GConfentry.
+@Returns: a new #GConfEntry
+
+
+<!-- ##### FUNCTION gconf_entry_new ##### -->
+<para>
+Creates a new #GConfEntry with key @key and value @val calling gconf_entry_new_nocopy ().
+</para>
+
+@key: the key name
+@val: the value
+@Returns: a new #GConfEntry.
+
+
+<!-- ##### FUNCTION gconf_entry_ref ##### -->
+<para>
+Increases the refcount of a #GConfEntry by one.
+</para>
+
+@entry: a #GConfEntry.
+
+
+<!-- ##### FUNCTION gconf_entry_unref ##### -->
+<para>
+Decreases the refcount of a #GConfEntry by one and  frees the
+#GConfEntry when the refcount becomes zero.
+</para>
+
+@entry: a #GConfEntry.
 
 
 <!-- ##### FUNCTION gconf_entry_free ##### -->
 <para>
 Destroys a #GConfEntry, freeing the key, the value, and the entry itself.
 </para>
 
 @entry: a #GConfEntry to free.
 
 
+<!-- ##### FUNCTION gconf_entry_copy ##### -->
+<para>
+Copies the fields of an existing #GConfEntry and returns the new #GConfEntry.
+</para>
+
+@src: the #GConfEntry to be copied.
+@Returns: the new #GConfEntry.
+
+
 <!-- ##### FUNCTION gconf_entry_get_key ##### -->
 <para>
 Accesses the @key field of a #GConfEntry. The returned key is not a
 copy, and should not be freed or modified.
 </para>
@@ -570,10 +606,37 @@ gconf_entry_steal_value() assumes owners
 
 @entry: a #GConfEntry.
 @Returns: a #GConfValue that the caller must free.
 
 
+<!-- ##### FUNCTION gconf_entry_get_is_writable ##### -->
+<para>
+Gets the is_writable field of the #GConfEntry and returns the boolean value.
+</para>
+
+@entry: a #GConfEntry.
+@Returns: a boolean value
+
+
+<!-- ##### FUNCTION gconf_entry_set_is_writable ##### -->
+<para>
+Sets the is_writable field of the #GConfEntry to the boolean value passed.
+</para>
+
+@entry: a #GConfEntry.
+@is_writable: a boolean value.
+
+
+<!-- ##### FUNCTION gconf_entry_set_value ##### -->
+<para>
+Sets the value field of the #GConfEntry to the #GConfValue passed.
+</para>
+
+@entry: a #GConfEntry.
+@val: a #GConfValue.
+
+
 <!-- ##### FUNCTION gconf_entry_get_is_default ##### -->
 <para>
 
 </para>
 
