summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJavier Jardón <jjardon@gnome.org>2010-10-22 17:56:00 +0200
committerJavier Jardón <jjardon@gnome.org>2010-10-22 17:59:38 +0200
commit8999053b5f931a8cee054fbc3abaf1edbd5b19a1 (patch)
tree445437b6479bbd9fba2450e5771cfd5c9554d4f8
parent1f77384ab349f078d386ad43ba9b5e3332aa3758 (diff)
downloadgtk+-8999053b5f931a8cee054fbc3abaf1edbd5b19a1.tar.gz
docs: Add gtk-doc notation
to emphasize that GtkMisc and GtkAdjustment are not encouraged in new code
-rw-r--r--docs/reference/gtk/tmpl/gtkmisc.sgml2
-rw-r--r--gtk/gtkalignment.c4
2 files changed, 6 insertions, 0 deletions
diff --git a/docs/reference/gtk/tmpl/gtkmisc.sgml b/docs/reference/gtk/tmpl/gtkmisc.sgml
index 57ab5c7090..c9016e2b0f 100644
--- a/docs/reference/gtk/tmpl/gtkmisc.sgml
+++ b/docs/reference/gtk/tmpl/gtkmisc.sgml
@@ -19,11 +19,13 @@ positioned within its allocated area. Note that if the widget is added to
a container in such a way that it expands automatically to fill its
allocated area, the alignment settings will not alter the widgets position.
</para>
+<note>
<para>
Note that the desired effect can in most cases be achieved by using the
#GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties
on the child widget, so GtkMisc should not be used in new code.
</para>
+</note>
<!-- ##### SECTION See_Also ##### -->
<para>
diff --git a/gtk/gtkalignment.c b/gtk/gtkalignment.c
index b3e0b85c79..d8b3fec570 100644
--- a/gtk/gtkalignment.c
+++ b/gtk/gtkalignment.c
@@ -42,9 +42,13 @@
* Of course, if the scale settings are both set to 1, the alignment settings
* have no effect.
*
+ * <note>
+ * <para>
* Note that the desired effect can in most cases be achieved by using the
* #GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties
* on the child widget, so #GtkAlignment should not be used in new code.
+ * </para>
+ * </note>
*/
#include "config.h"