From 3471f8f69e25ffebe96dc55173096cedc738ca6f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 6 Nov 2021 10:17:20 -0400 Subject: [PATCH] docs: Clarify a doc comment Reword the docs for hb_ot_layout_script_select_language and be a bit more specific about the returned index. --- src/hb-ot-layout.cc | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/src/hb-ot-layout.cc b/src/hb-ot-layout.cc index 1e446c66f..ed7058b08 100644 --- a/src/hb-ot-layout.cc +++ b/src/hb-ot-layout.cc @@ -717,10 +717,14 @@ hb_ot_layout_script_find_language (hb_face_t *face, * @language_tags: The array of language tags * @language_index: (out): The index of the requested language * - * Fetches the index of a given language tag in the specified face's GSUB table - * or GPOS table, underneath the specified script index. + * Fetches the index of the first language tag fom @language_tags that is present + * in the specified face's GSUB or GPOS table, underneath the specified script + * index. * - * Return value: %true if the language tag is found, %false otherwise + * If none of the given language tags is found, %false is returned and + * @language_index is set to the default language index. + * + * Return value: %true if one of the given language tags is found, %false otherwise * * Since: 2.0.0 **/ @@ -1016,7 +1020,7 @@ struct hb_collect_features_context_t hb_set_t features_set; for (; *features; features++) features_set.add (*features); - + for (unsigned i = 0; i < g.get_feature_count (); i++) { hb_tag_t tag = g.get_feature_tag (i);