gnomemm r1689 - in gconfmm/trunk: . docs/reference gconf/src

[murrayc svn gnome org]

Author: murrayc
Date: Mon Aug 25 11:57:14 2008
New Revision: 1689
URL: http://svn.gnome.org/viewvc/gnomemm?rev=1689&view=rev

Log:
2008-08-25  Murray Cumming  <murrayc murrayc com>

* docs/reference/Doxyfile.in: Added newin2p* ALIASES, as in 
gtkmm, to mark new API.
* gconf/src/client.hg: recursive_unset(): Added a suitable 
default value for the flags parameter.
Added notify().
Used @newin2p24 in the documentation. 

Modified:
   gconfmm/trunk/ChangeLog
   gconfmm/trunk/docs/reference/Doxyfile.in
   gconfmm/trunk/gconf/src/client.hg

Modified: gconfmm/trunk/docs/reference/Doxyfile.in
==============================================================================
--- gconfmm/trunk/docs/reference/Doxyfile.in	(original)
+++ gconfmm/trunk/docs/reference/Doxyfile.in	Mon Aug 25 11:57:14 2008
@@ -32,6 +32,8 @@
 SORT_MEMBER_DOCS       = YES
 DISTRIBUTE_GROUP_DOC   = NO
 TAB_SIZE               = 8
+ALIASES                = "newin2p24=\xrefitem newin2p24s \"Since gconfmm 2.24\" \"New API in gconfmm 2.24\" \n" \
+                         "newin2p26=\xrefitem newin2p26s \"Since gconfmm 2.26\" \"New API in gconfmm 2.26\" \
 GENERATE_TODOLIST      = YES
 GENERATE_TESTLIST      = YES
 GENERATE_BUGLIST       = YES

Modified: gconfmm/trunk/gconf/src/client.hg
==============================================================================
--- gconfmm/trunk/gconf/src/client.hg	(original)
+++ gconfmm/trunk/gconf/src/client.hg	Mon Aug 25 11:57:14 2008
@@ -214,6 +214,13 @@
      * @see notify_add()
      */
     _WRAP_METHOD(void notify_remove(guint cnxn), gconf_client_notify_remove, errthrow)
+
+    /** Emits the value_changed signal and notifies listeners as if @a key had been changed.
+     * @param key The key that has changed.
+     *
+     * @newin2p24
+     */ 
+    _WRAP_METHOD(void notify(const Glib::ustring& key), gconf_client_notify)
     
     _WRAP_METHOD(void set_error_handling(ClientErrorHandlingMode mode), gconf_client_set_error_handling)
     
@@ -276,12 +283,15 @@
      */
     _WRAP_METHOD(void unset(const Glib::ustring& key), gconf_client_unset, errthrow)
 
-    /** Recursively unset all keys below key and key it self.
-     * @param key the configuration key to unset.
-     * @param flags change how the unset is done.
+    /** Unsets all keys below @a key, including @a key itself.
+     * If any unset fails, it continues on to unset as much as it can. The first failure is then thrown as an exception.
+     * @param key The configuration key to unset.
+     * @param flags Change how the unset is done.
      * @throw Gnome::Conf::Error.
+     *
+     * @newin2p24
      */
-    _WRAP_METHOD(void recursive_unset(const Glib::ustring& key, UnsetFlags flags), gconf_client_recursive_unset, errthrow)
+    _WRAP_METHOD(void recursive_unset(const Glib::ustring& key, UnsetFlags flags = UNSET_INCLUDING_SCHEMA_NAMES), gconf_client_recursive_unset, errthrow)
     
     /** Retrieve all keys in the given configuration directory.
      * Get all the configuration keys in the given directory, without recursion.