summaryrefslogtreecommitdiff
path: root/pango/break.c
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2019-07-14 12:25:24 -0400
committerMatthias Clasen <mclasen@redhat.com>2019-07-16 10:22:20 -0400
commitcc9b0912566b7c3bd4c1b31b5e6dd8532f1794c1 (patch)
tree13a14f65ff638e82537032b40c13c8e043bb567d /pango/break.c
parent0010317b93722f19d636b7dd91c735fcdfd47997 (diff)
downloadpango-cc9b0912566b7c3bd4c1b31b5e6dd8532f1794c1.tar.gz
Deprecate pango_break
To break correctly, use pango_default_break and pango_tailor_break.
Diffstat (limited to 'pango/break.c')
-rw-r--r--pango/break.c18
1 files changed, 9 insertions, 9 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,