diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index ed2add64bd..dfa2a17977 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -151,7 +151,7 @@
  *
  * Height for width requests are generally implemented in terms of a virtual allocation
  * of widgets in the input orientation. Assuming an height-for-width request mode, a container
- * would implement the <function>get_preferred_height_for_width()</function> virtual function by first calling
+ * would implement the <function>get_preferred_height_for_width(<!-- -->)</function> virtual function by first calling
  * gtk_widget_get_preferred_width() for each of its children.
  *
  * For each potential group of children that are lined up horizontally, the values returned by
diff --git a/gtk/gtkcontainer.h b/gtk/gtkcontainer.h
index fdeed7b3f1..29d510fe63 100644
--- a/gtk/gtkcontainer.h
+++ b/gtk/gtkcontainer.h
@@ -253,13 +253,13 @@ void gtk_container_child_notify (GtkContainer *container,
 
 /**
  * GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID:
- * @object: the #GObject on which set_child_property() or get_child_property()
+ * @object: the #GObject on which set_child_property(<!-- -->) or get_child_property(<!-- -->)
  *  was called
  * @property_id: the numeric id of the property
  * @pspec: the #GParamSpec of the property
  *
  * This macro should be used to emit a standard warning about unexpected
- * properties in set_child_property() and get_child_property() implementations.
+ * properties in set_child_property(<!-- -->) and get_child_property(<!-- -->) implementations.
  */
 #define GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID(object, property_id, pspec) \
     G_OBJECT_WARN_INVALID_PSPEC ((object), "child property id", (property_id), (pspec))