From 9bb2ab5eb170c4a0803b325bfc610f01974a2761 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 12 Jul 2019 17:26:24 -0400 Subject: Document pango_item_apply_attrs --- pango/pango-item.c | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/pango/pango-item.c b/pango/pango-item.c index 787fb65e..d2d45aab 100644 --- a/pango/pango-item.c +++ b/pango/pango-item.c @@ -163,6 +163,24 @@ compare_attr (gconstpointer p1, gconstpointer p2) return 1; } +/** + * pango_item_apply_attrs: + * @item: a #PangoItem + * @iter: a #PangoAttrIterator + * + * Add attributes to a PangoItem. The idea is that you have + * attributes that don't affect itemization, such as font features, + * so you filter them out using pango_attr_list_filter(), itemize + * your text, then reapply the attributes to the resulting items + * using this function. + * + * The @iter should be positioned before the range of the item, + * and will be advanced past it. This function is meant to be called + * in a loop over the items resulting from itemization, while passing + * the iter to each call. + * + * Since: 1.44 + */ void pango_item_apply_attrs (PangoItem *item, PangoAttrIterator *iter) -- cgit v1.2.1