[gtk/matthiasc/for-master: 10/12] docs: Tweak GdkPopup docs

[Matthias Clasen <matthiasc src gnome org>]

commit 94305f248b04285ed3386f74f220c7a8b109424a
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Oct 29 14:00:13 2020 -0400

    docs: Tweak GdkPopup docs

 gdk/gdkpopup.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
---
diff --git a/gdk/gdkpopup.c b/gdk/gdkpopup.c
index 91772d3c18..375a0fcb92 100644
--- a/gdk/gdkpopup.c
+++ b/gdk/gdkpopup.c
@@ -27,9 +27,13 @@
  * SECTION:gdkpopup
  * @Short_description: Interface for popup surfaces
  * @Title: Popups
+ * @See_also: #GdkToplevel, #GdkSurface
  *
  * A #GdkPopup is a surface that is attached to another surface,
- * and is positioned relative to it.
+ * called its #GdkPopup:parent, and is positioned relative to it.
+ *
+ * #GdkPopups are typically used to implement menus and similar popups.
+ * They can be modal, which is indicated by the #GdkPopup:autohide property.
  */
 
 G_DEFINE_INTERFACE (GdkPopup, gdk_popup, GDK_TYPE_SURFACE)