From 6a2d02961dc1aed6c8fd472f1646ba12b3420b70 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 27 May 2019 14:11:36 +0000 Subject: Add more deprecation notes around PangoScript Make it clear that PangoScript is deprecated, and will not be updated. And that all APIs are in fact returning GUnicodeScript, and callers have to handle that. --- pango/pango-script.c | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) (limited to 'pango/pango-script.c') diff --git a/pango/pango-script.c b/pango/pango-script.c index 43be3fa0..4faf2b91 100644 --- a/pango/pango-script.c +++ b/pango/pango-script.c @@ -73,13 +73,15 @@ * pango_script_for_unichar: * @ch: a Unicode character * - * Looks up the #PangoScript for a particular character (as defined by + * Looks up the script for a particular character (as defined by * Unicode Standard Annex \#24). No check is made for @ch being a * valid Unicode character; if you pass in invalid character, the * result is undefined. * - * As of Pango 1.18, this function simply returns the return value of - * g_unichar_get_script(). + * Note that while the return type of this function is declared + * as PangoScript, as of Pango 1.18, this function simply returns + * the return value of g_unichar_get_script(). Callers must be + * prepared to handle unknown values. * * Return value: the #PangoScript for the character. * @@ -170,6 +172,11 @@ pango_script_iter_free (PangoScriptIter *iter) * The range is the set of locations p where *start <= p < *end. * (That is, it doesn't include the character stored at *end) * + * Note that while the type of the @script argument is declared + * as PangoScript, as of Pango 1.18, this function simply returns + * GUnicodeScript values. Callers must be prepared to handle unknown + * values. + * * Since: 1.4 **/ void -- cgit v1.2.1