diff options
author | Matthias Clasen <mclasen@redhat.com> | 2022-12-10 16:36:00 -0500 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2022-12-10 16:36:00 -0500 |
commit | 5df9f4016e79e367c68d7b99740db81834bf29b2 (patch) | |
tree | 6264f88d6c3b43891428e03a33217e36fc5a2463 /gtk | |
parent | 6f7a4b67c2502f6ad3cef43889e2f020255d2a72 (diff) | |
download | gtk+-5df9f4016e79e367c68d7b99740db81834bf29b2.tar.gz |
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.
Diffstat (limited to 'gtk')
-rw-r--r-- | gtk/gtkpopover.c | 8 |
1 files changed, 7 insertions, 1 deletions
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) |