[gtkmm/gtkmm-2-22] Widget: Document the set_flags() and unset_flags() deprecation.

[Murray Cumming <murrayc src gnome org>]

commit 109cf32d2179b327287f5eae2071dc8095c88145
Author: Murray Cumming <murrayc murrayc com>
Date:   Mon Sep 20 13:01:02 2010 +0200

    Widget: Document the set_flags() and unset_flags() deprecation.
    
    * gtk/src/widget.hg: Add doxygen comments based on the C documentation.

 ChangeLog         |    6 ++++++
 gtk/src/widget.hg |   14 ++++++++++++--
 2 files changed, 18 insertions(+), 2 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 62c423a..899c7fb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2010-09-20  Murray Cumming  <murrayc murrayc com>
 
+	Widget: Document the set_flags() and unset_flags() deprecation.
+
+	* gtk/src/widget.hg: Add doxygen comments based on the C documentation.
+
+2010-09-20  Murray Cumming  <murrayc murrayc com>
+
 	Added some missing properties.
 
 	* gtk/src/iconview.hg: Added tooltip-column and reorderable and
diff --git a/gtk/src/widget.hg b/gtk/src/widget.hg
index 411b2ad..00b485f 100644
--- a/gtk/src/widget.hg
+++ b/gtk/src/widget.hg
@@ -662,10 +662,20 @@ _DEPRECATE_IFDEF_START
    */
   WidgetFlags get_flags() const;
 
-  //TODO: Document the deprecation when GTK+ does.
+  /**
+   * @deprecated Use the proper function instead, such as set_app_paintable(),
+   * set_can_default(), set_can_focus(), set_double_buffered(),
+   * set_has_window(), set_mapped(), set_no_show_all(), set_realized(),
+   * set_receives_default(), set_sensitive() or set_visible().
+   */
   void set_flags(WidgetFlags flags);
 
-  //TODO: Document the deprecation when GTK+ does.
+  /**
+   * @deprecated Use the proper function instead, such as set_app_paintable(),
+   * set_can_default(), set_can_focus(), set_double_buffered(),
+   * set_has_window(), set_mapped(), set_no_show_all(), set_realized(),
+   * set_receives_default(), set_sensitive() or set_visible().
+   */
   void unset_flags(WidgetFlags flags);
 
   //TODO: Remove this when we can break ABI: