Improve deprecation annotations

svn path=/trunk/; revision=21815

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 8622a34d949505edcb5be64d028d9babe6bad1e0..d4bac676f787dfaf7e721daa07325178a2974a97 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,16 @@
+2008-11-29  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/tmpl/gtkbbox.sgml: Improve deprecation annotations.
+
+2008-11-21  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/Makefile.am:
+       * gdk/Makefile.am:
+       * gdk-pixbuf/Makefile.am: Use a new gtk-doc feature to generate
+       much nicer indices.
+
+       * gtk/drawing-model.xml: Fix document structure
+
 2008-11-25  Christian Dywan  <christian@imendio.com>
 
        Bug 559009 – gtk_radio_button_get_group documentation needs

diff --git a/docs/reference/gtk/tmpl/gtkbbox.sgml b/docs/reference/gtk/tmpl/gtkbbox.sgml
index 53dcbb99affbe689094419b78d8248e8407aa35b..ae4b411a61f86a58b857ea4ec73f8913593dc6c1 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkbbox.sgml
@@ -100,7 +100,8 @@ Retrieves how much space a button box is placing between each child button.
 </para>
 
 @b: a #GtkButtonBox
-@Returns: the current spacing applied to the buttons in @widget.
+@Returns: the current spacing applied to the buttons in @widget
+@Deprecated: Use gtk_box_get_spacing() instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_get_layout ##### -->
@@ -133,8 +134,11 @@ Gets the default number of pixels that pad the buttons in a given button box.
 @widget: a #GtkButtonBox.
 @ipad_x: the horizontal padding used by buttons in @widget.
 @ipad_y: the vertical padding used by buttons in @widget.
-@Deprecated: Use the style properties
-<literal>"child-internal-pad-x/-y"</literal> instead.
+@Deprecated: Use the style properties 
+  "<link linkend="GtkButtonBox--s-child-internal-pad-x">child-internal-pad-x</link>"
+  and
+  "<link linkend="GtkButtonBox--s-child-internal-pad-y">child-internal-pad-y</link>"
+  instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_get_child_secondary ##### -->
@@ -152,8 +156,9 @@ Gets the default number of pixels that pad the buttons in a given button box.
 Sets the amount of spacing between buttons in a given button box.
 </para>
 
-@b: a #GtkButtonBox.
-@s: the number of pixels of spacing.
+@b: a #GtkButtonBox
+@s: the number of pixels of spacing
+@Deprecated: Use gtk_box_set_spacing() instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_set_layout ##### -->
@@ -170,11 +175,14 @@ Changes the way buttons are arranged in their container.
 Sets a new default size for the children of a given button box.
 </para>
 
-@widget: a #GtkButtonBox.
-@min_width: a default width for buttons in @widget.
-@min_height: a default height for buttons in @widget.
+@widget: a #GtkButtonBox
+@min_width: a default width for buttons in @widget
+@min_height: a default height for buttons in @widget
 @Deprecated: Use the style properties
-<literal>"child-min-width/-height"</literal> instead.
+  "<link linkend="GtkButtonBox--s-child-min-width">child-min-width</link>"
+  and
+  "<link linkend="GtkButtonBox--s-child-min-height">child-min-height</link>"
+  instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_set_child_ipadding ##### -->