diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index f1cae55a4f..d514e64b04 100644
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -2827,8 +2827,8 @@ gdk_motion_event_new (GdkSurface      *surface,
  * Retrieves the history of the @event motion, as a list of time and
  * coordinates.
  *
- * Returns: (transfer container) (element-type GdkTimeCoord) (nullable): a list
- *   of time and coordinates
+ * Returns: (transfer container) (array length=out_n_coords) (nullable): an
+ *   array of time and coordinates
  */
 GdkTimeCoord *
 gdk_motion_event_get_history (GdkEvent *event,
diff --git a/gtk/gtktextchild.c b/gtk/gtktextchild.c
index fb2b0f14c8..9ef3184673 100644
--- a/gtk/gtktextchild.c
+++ b/gtk/gtktextchild.c
@@ -432,10 +432,11 @@ gtk_text_child_anchor_finalize (GObject *obj)
  * @anchor: a #GtkTextChildAnchor
  * 
  * Gets a list of all widgets anchored at this child anchor.
- * The returned list should be freed with g_list_free().
  *
+ * The order in which the widgets are returned is not defined.
  *
- * Returns: (element-type GtkWidget) (transfer container): list of widgets anchored at @anchor
+ * Returns: (array length=out_len) (transfer container): an
+ *   array of widgets anchored at @anchor
  **/
 GtkWidget **
 gtk_text_child_anchor_get_widgets (GtkTextChildAnchor *anchor,