[pango/gi-docs: 23/28] docs: Tweak reorder docs

[Matthias Clasen <matthiasc src gnome org>]

commit d2b70f94c60b60c2158b014e3cd7b7ec242ff1b4
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Feb 19 08:22:11 2021 -0500

    docs: Tweak reorder docs

 pango/reorder-items.c | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)
---
diff --git a/pango/reorder-items.c b/pango/reorder-items.c
index 62a6a8f9..d00fee4c 100644
--- a/pango/reorder-items.c
+++ b/pango/reorder-items.c
@@ -31,11 +31,13 @@ static GList *reorder_items_recurse (GList *items, int n_items);
 
 /**
  * pango_reorder_items:
- * @logical_items: (element-type Pango.Item): a #GList of #PangoItem in logical order.
+ * @logical_items: (element-type Pango.Item): a `GList` of `PangoItem`
+ *   in logical order.
  *
- * From a list of items in logical order and the associated
- * directional levels, produce a list in visual order.
- * The original list is unmodified.
+ * Reorder items from logical order to visual order.
+ *
+ * The visual order is determined from the associated directional
+ * levels of the items. The original list is unmodified.
  *
  * Returns: (transfer full) (element-type Pango.Item): a #GList
  *          of #PangoItem structures in visual order.