diff --git a/docs/reference/gtk/tmpl/gtktable.sgml b/docs/reference/gtk/tmpl/gtktable.sgml
index 22503eaa39..6264b6eea3 100644
--- a/docs/reference/gtk/tmpl/gtktable.sgml
+++ b/docs/reference/gtk/tmpl/gtktable.sgml
@@ -32,11 +32,13 @@ either side</emphasis> of the widget it belongs to.
 gtk_table_set_homogeneous(), can be used to set whether all cells in the
 table will resize themselves to the size of the largest widget in the table.
 </para>
+<note>
 <para>
 Note that #GtkGrid provides the same capabilities as GtkTable for arranging
 widgets in a rectangular grid, and additionally supports height-for-width
 geometry management.
 </para>
+</note>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
diff --git a/gtk/gtkbox.c b/gtk/gtkbox.c
index 50e827de85..ef519686bb 100644
--- a/gtk/gtkbox.c
+++ b/gtk/gtkbox.c
@@ -75,8 +75,12 @@
  * #GtkBox:fill and #GtkBox:padding child properties.
  * Use gtk_box_query_child_packing() to query these fields.
  *
+ * <note>
+ * <para>
  * Note that a single-row or single-column #GtkGrid provides exactly the
  * same functionality as #GtkBox.
+ * </para>
+ * </note>
  */
 
 #include "config.h"