[gtk+] More deprecation docs for GtkArrow

[Matthias Clasen <matthiasc src gnome org>]

commit 8b0b024385a201808265b6a42c1922885f9b1c2a
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue May 13 23:52:47 2014 -0400

    More deprecation docs for GtkArrow

 gtk/deprecated/gtkarrow.c |    8 +++++++-
 1 files changed, 7 insertions(+), 1 deletions(-)
---
diff --git a/gtk/deprecated/gtkarrow.c b/gtk/deprecated/gtkarrow.c
index b4c14d1..dd76f1e 100644
--- a/gtk/deprecated/gtkarrow.c
+++ b/gtk/deprecated/gtkarrow.c
@@ -42,7 +42,13 @@
  * style of an arrow can be changed after creation by using gtk_arrow_set().
  *
  * GtkArrow has been deprecated; you can simply use a #GtkImage with a
- * suitable icon name, such as “pan-down-symbolic“.
+ * suitable icon name, such as “pan-down-symbolic“. When replacing 
+ * GtkArrow by an image, pay attention to the fact that GtkArrow is
+ * doing automatic flipping between #GTK_ARROW_LEFT and #GTK_ARROW_RIGHT,
+ * depending on the text direction. To get the same effect with an image,
+ * use the icon names “pan-start-symbolic“ and “pan-end-symbolic“, which
+ * react to the text direction instead of “pan-left-symbolic“ and
+ * “pan-right-symbolic“ which don't.
  */
 
 #include "config.h"