From 5df9f4016e79e367c68d7b99740db81834bf29b2 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 10 Dec 2022 16:36:00 -0500 Subject: [PATCH] popover: Clarify docs gtk_popover_present() is a misleadingly named function, so at least give it clear docs that tell people to use gtk_popover_popup() instead. --- gtk/gtkpopover.c | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/gtk/gtkpopover.c b/gtk/gtkpopover.c index 529e294092..5d005f57ca 100644 --- a/gtk/gtkpopover.c +++ b/gtk/gtkpopover.c @@ -598,7 +598,13 @@ present_popup (GtkPopover *popover) * gtk_popover_present: * @popover: a `GtkPopover` * - * Presents the popover to the user. + * Allocate a size for the `GtkPopover`. + * + * This function needs to be called in size-allocate by widgets + * who have a `GtkPopover` as child. When using a layout manager, + * this is happening automatically. + * + * To make a popover appear on screen, use [method@Gtk.Popover.popup]. */ void gtk_popover_present (GtkPopover *popover) -- 2.30.2