[pango/tailor-break: 3/3] Deprecate pango_break

[Matthias Clasen <matthiasc src gnome org>]

commit cbb2be7946f13bee73c36d4eadf18041c0742d7b
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Jul 14 12:25:24 2019 -0400

    Deprecate pango_break
    
    To break correctly, use pango_default_break and
    pango_tailor_break.

 pango/break.c       | 18 +++++++++---------
 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,