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.
This commit is contained in:
Matthias Clasen 2022-12-10 16:36:00 -05:00
parent 6f7a4b67c2
commit 5df9f4016e

View File

@ -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)