[gtk/matthiasc/for-master: 1/3] popup: Mention the popover arrow in the docs

[Matthias Clasen <matthiasc src gnome org>]

commit d1fcfa58b9319d8ec75b2fb99eba4ff90f0e801e
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Jan 5 10:59:59 2021 -0500

    popup: Mention the popover arrow in the docs
    
    Suggested by Jonas.

 gdk/gdkpopuplayout.c | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)
---
diff --git a/gdk/gdkpopuplayout.c b/gdk/gdkpopuplayout.c
index bff14a935c..7192ef259d 100644
--- a/gdk/gdkpopuplayout.c
+++ b/gdk/gdkpopuplayout.c
@@ -51,11 +51,16 @@
  *
  * ![Sliding popups](popup-slide.png)
  *
- * These hints may be combined, but it is ultimatively up to the windowing
- * system to determine the position and size of the popup. You can learn
- * about the result by calling gdk_popup_get_position_x(),
- * gdk_popup_get_position_y(), gdk_popup_get_rect_anchor() and
- * gdk_popup_get_surface_anchor() after the popup has been presented.
+ * These hints may be combined.
+ *
+ * Ultimatively, it is up to the windowing system to determine the position
+ * and size of the popup. You can learn about the result by calling
+ * gdk_popup_get_position_x(), gdk_popup_get_position_y(),
+ * gdk_popup_get_rect_anchor() and gdk_popup_get_surface_anchor() after the
+ * popup has been presented. This can be used to adjust the rendering. For
+ * example, GtkPopover changes its arrow position accordingly. But you have
+ * to be careful avoid changing the size of the popover, or it has to be
+ * presented again.
  */
 
 struct _GdkPopupLayout