[gtk/matthiasc/for-master] popover: Update docs

[Matthias Clasen <matthiasc src gnome org>]

commit 17520137deb94fedf0c601ac1719503f6ce331d9
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue May 18 14:50:03 2021 -0400

    popover: Update docs
    
    Remove mention of show/hide animations, and mention
    cascading close instead.
    
    Fixes: #3960

 gtk/gtkpopover.c | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)
---
diff --git a/gtk/gtkpopover.c b/gtk/gtkpopover.c
index 5c1953ddaf..0b93073daa 100644
--- a/gtk/gtkpopover.c
+++ b/gtk/gtkpopover.c
@@ -2228,11 +2228,6 @@ gtk_popover_get_autohide (GtkPopover *popover)
  * @popover: a `GtkPopover`
  *
  * Pops @popover up.
- *
- * This is different from a [method Gtk Widget show() call
- * in that it may show the popover with a transition. If
- * you want to show the popover without a transition, just
- * use [method Gtk Widget show].
  */
 void
 gtk_popover_popup (GtkPopover *popover)
@@ -2273,10 +2268,8 @@ cascade_popdown (GtkPopover *popover)
  *
  * Pops @popover down.
  *
- * This is different from a [method Gtk Widget hide] call
- * in that it may show the popover with a transition. If
- * you want to hide the popover without a transition, just
- * use [method Gtk Widget hide].
+ * This may have the side-effect of closing a parent popover
+ * as well. See [property@Gtk.Popover:cascade-popdown].
  */
 void
 gtk_popover_popdown (GtkPopover *popover)