diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2019-07-14 12:25:24 -0400 |
|---|---|---|
| committer | Matthias Clasen <mclasen@redhat.com> | 2019-07-16 10:22:20 -0400 |
| commit | cc9b0912566b7c3bd4c1b31b5e6dd8532f1794c1 (patch) | |
| tree | 13a14f65ff638e82537032b40c13c8e043bb567d | |
| parent | 0010317b93722f19d636b7dd91c735fcdfd47997 (diff) | |
| download | pango-cc9b0912566b7c3bd4c1b31b5e6dd8532f1794c1.tar.gz | |
Deprecate pango_break
To break correctly, use pango_default_break and
pango_tailor_break.
| -rw-r--r-- | pango/break.c | 18 | ||||
| -rw-r--r-- | pango/pango-break.h | 5 |
2 files changed, 10 insertions, 13 deletions
diff --git a/pango/break.c b/pango/break.c index 0b3f908a..8066fca0 100644 --- a/pango/break.c +++ b/pango/break.c @@ -146,13 +146,11 @@ typedef enum * @attrs: logical attributes to fill in * @attrs_len: size of the array passed as @attrs * - * This is the default break algorithm, used if no language - * engine overrides it. Normally you should use pango_break() - * instead. Unlike pango_break(), - * @analysis can be %NULL, but only do that if you know what - * you're doing. If you need an analysis to pass to pango_break(), - * you need to pango_itemize(). In most cases however you should - * simply use pango_get_log_attrs(). + * This is the default break algorithm. It applies Unicode + * rules without language-specific tailoring, therefore + * the @analyis argument is unused and can be %NULL. + * + * See pango_tailor_break() for language-specific breaks. **/ void pango_default_break (const gchar *text, @@ -1604,8 +1602,10 @@ tailor_break (const gchar *text, * @attrs_len: size of the array passed as @attrs * * Determines possible line, word, and character breaks - * for a string of Unicode text with a single analysis. For most - * purposes you may want to use pango_get_log_attrs(). + * for a string of Unicode text with a single analysis. + * For most purposes you may want to use pango_get_log_attrs(). + * + * Deprecated: 1.44: Use pango_default_break() and pango_tailor_break() */ void pango_break (const gchar *text, diff --git a/pango/pango-break.h b/pango/pango-break.h index 2824e37f..4e1db0bc 100644 --- a/pango/pango-break.h +++ b/pango/pango-break.h @@ -100,10 +100,7 @@ struct _PangoLogAttr guint is_word_boundary : 1; }; -/* Determine information about cluster/word/line breaks in a string - * of Unicode text. - */ -PANGO_AVAILABLE_IN_ALL +PANGO_DEPRECATED_IN_1_44 void pango_break (const gchar *text, int length, PangoAnalysis *analysis, |