[gtk+/gtk-2-24] GtkFixed: Update documentation intro

[Daniel Boles <dboles src gnome org>]

commit 277c8286a179e496f75600dfe074c7fc9380bea6
Author: Daniel Boles <dboles src gnome org>
Date:   Thu Aug 3 13:09:59 2017 +0100

    GtkFixed: Update documentation intro
    
    • Add GtkLayout as a @See_also since it includes fixed-pos functionality
    • Explain how to work around the problems with RTL text

 docs/reference/gtk/tmpl/gtkfixed.sgml |   22 +++++++++++++++-------
 1 files changed, 15 insertions(+), 7 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/gtkfixed.sgml b/docs/reference/gtk/tmpl/gtkfixed.sgml
index 45e8e22..8c8d3bb 100644
--- a/docs/reference/gtk/tmpl/gtkfixed.sgml
+++ b/docs/reference/gtk/tmpl/gtkfixed.sgml
@@ -26,8 +26,8 @@ overlapping widgets, and other display bugs:
 <para>Fonts other than the one you used to write the app will of
 course change the size of widgets containing text; keep in mind that
 users may use a larger font because of difficulty reading the default,
-or they may be using Windows or the framebuffer port of GTK+, where
-different fonts are available.
+or they may be using a different OS or the framebuffer port of GTK+, in which
+different fonts may be available.
 </para>
 </listitem>
 <listitem>
@@ -40,11 +40,13 @@ display of non-English text will use a different font in many cases.
 </para>
 
 <para>
-In addition, the fixed widget can't properly be mirrored in
-right-to-left languages such as Hebrew and Arabic. i.e. normally GTK+
-will flip the interface to put labels to the right of the thing they
-label, but it can't do that with #GtkFixed. So your application will 
-not be usable in right-to-left languages.
+In addition, #GtkFixed does not pay attention to text direction and thus may
+produce unwanted results if your app is run under right-to-left languages such
+as Hebrew or Arabic. That is: normally GTK+ will order containers appropriately
+for the text direction, e.g. to put labels to the right of the thing they label
+when using an RTL language, but it can’t do that with #GtkFixed. So if you need
+to reorder widgets depending on the text direction, you would need to manually
+detect it and adjust child positions accordingly.
 </para>
 
 <para>
@@ -59,7 +61,13 @@ and prefer the simplicity of #GtkFixed, by all means use the
 widget. But you should be aware of the tradeoffs.
 </para>
 
+<para>
+See also #GtkLayout, which shares the ability to perform fixed positioning of
+child widgets and additionally adds custom drawing and scrollability.
+</para>
+
 <!-- ##### SECTION See_Also ##### -->
+#GtkLayout
 <para>
 
 </para>