[pango/better-ellipsize] Improve the docs

[Matthias Clasen <matthiasc src gnome org>]

commit 34fd3f450a4d2c0b160d4d7f0a03ec26cb81ca8e
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Jul 22 07:09:14 2021 -0400

    Improve the docs
    
    Clarify that pango_attr_iterator_get_attrs is not
    providing the same fonts as pango_itemize would use.

 pango/pango-attributes.c | 5 +++++
 1 file changed, 5 insertions(+)
---
diff --git a/pango/pango-attributes.c b/pango/pango-attributes.c
index 26d08404..d5711504 100644
--- a/pango/pango-attributes.c
+++ b/pango/pango-attributes.c
@@ -2456,6 +2456,11 @@ pango_attr_list_filter (PangoAttrList       *list,
  * Gets a list of all attributes at the current position of the
  * iterator.
  *
+ * Note that this method only returns the innermost attribute of
+ * each kind and does not merge overlapping font attributes. If you
+ * want to get the same font that [func@Pango.itemize] would use
+ * with these attributes, use [method@Pango.AttrIterator.get_font].
+ *
  * Return value: (element-type Pango.Attribute) (transfer full):
  *   a list of all attributes for the current range. To free
  *   this value, call [method@Pango.Attribute.destroy] on each