Improve deprecation annotations

svn path=/trunk/; revision=21814

diff --git a/ChangeLog b/ChangeLog
index e3aecd3003a8af7aa50f3dc9d698279d09aa30b8..a89965ae8272113af81d670e28458192e6212b86 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-11-29  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkbindings.c: Improve deprecation annotations.
+
 2008-11-26  Christian Dywan  <christian@imendio.com>
 
        Bug 561504 – testgtk should load rc file from sub folder

diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c
index 49c1e7918d4a72b3bb429fd28096bd1a0d48aff0..cdf7951b2d7b32d3e55f30f3da9fb0f0a72f33f0 100644 (file)
--- a/gtk/gtkbindings.c
+++ b/gtk/gtkbindings.c
@@ -706,13 +706,26 @@ gtk_binding_entry_clear_internal (GtkBindingSet  *binding_set,
   entry = binding_entry_new (binding_set, keyval, modifiers);
 }
 
+/**
+ * gtk_binding_entry_add:
+ * @binding_set: @binding_set to clear an entry of
+ * @keyval:      key value of binding to clear
+ * @modifiers:   key modifier of binding to clear
+ *
+ * Adds a binding entry.
+ *
+ * Deprecated: 2.12: Use gtk_binding_entry_add_signal() instead.
+ */
+
 /**
  * gtk_binding_entry_clear:
  * @binding_set: @binding_set to clear an entry of
  * @keyval:      key value of binding to clear
  * @modifiers:   key modifier of binding to clear
  *
- * Use of this function is deprecated.
+ * Clears a binding entry.
+ *
+ * Deprecated: 2.12: Use gtk_binding_entry_remove() instead.
  **/
 void
 gtk_binding_entry_clear (GtkBindingSet *binding_set,
@@ -790,7 +803,10 @@ gtk_binding_entry_remove (GtkBindingSet     *binding_set,
  * @signal_name:  signal name to be bound
  * @binding_args: list of #GtkBindingArg signal arguments
  *
- * Deprecated.
+ * Override or install a new key binding for @keyval with @modifiers on
+ * @binding_set.
+ *
+ * Deprecated: 2.12: Use gtk_binding_entry_add_signal() instead.
  **/
 void
 gtk_binding_entry_add_signall (GtkBindingSet  *binding_set,
@@ -1576,9 +1592,11 @@ gtk_binding_parse_bind (GScanner       *scanner,
  * gtk_binding_parse_binding:
  * @scanner: GtkRC scanner
  *
- * Deprecated as public API, used only internally.
+ * Parse a binding entry from a gtkrc file.
  *
  * Return value: expected token upon errors, %G_TOKEN_NONE on success.
+ *
+ * Deprecated: 2.12: There should be no need to call this function outside GTK+.
  **/
 guint
 gtk_binding_parse_binding (GScanner *scanner)