[pango] Deprecate much of pango-utils.h

[Khaled Hosny <khaledh src gnome org>]

commit f79b50df9d6116759cca5b043692e8d67e3c0984
Author: Khaled Hosny <khaledhosny eglug org>
Date:   Mon Apr 13 23:40:38 2015 +0200

    Deprecate much of pango-utils.h
    
    These all are general utility functions that do not belong to Pango’s
    public interface. Most of them are unused internally now, the few ones
    that are still used should be made private at some point.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=682840

 pango/pango-utils.c |   16 ++++++++++++++++
 pango/pango-utils.h |    8 ++++++++
 2 files changed, 24 insertions(+), 0 deletions(-)
---
diff --git a/pango/pango-utils.c b/pango/pango-utils.c
index eb01fa6..ecbea54 100644
--- a/pango/pango-utils.c
+++ b/pango/pango-utils.c
@@ -159,6 +159,8 @@ pango_version_check (int required_major,
  * Trims leading and trailing whitespace from a string.
  *
  * Return value: A newly-allocated string that must be freed with g_free()
+ *
+ * Deprecated: 1.37
  **/
 char *
 pango_trim_string (const char *str)
@@ -186,6 +188,8 @@ pango_trim_string (const char *str)
  *
  * Return value: (transfer full) (array zero-terminated=1): a list of
  * strings to be freed with g_strfreev()
+ *
+ * Deprecated: 1.37
  **/
 char **
 pango_split_file_list (const char *str)
@@ -257,6 +261,8 @@ pango_split_file_list (const char *str)
  * Return value: 0 if the stream was already at an %EOF character, otherwise
  *               the number of lines read (this is useful for maintaining
  *               a line number counter which doesn't combine lines with '\')
+ *
+ * Deprecated: 1.37
  **/
 gint
 pango_read_line (FILE *stream, GString *str)
@@ -358,6 +364,8 @@ pango_read_line (FILE *stream, GString *str)
  *
  * Return value: %FALSE if skipping the white space leaves
  * the position at a '\0' character.
+ *
+ * Deprecated: 1.37
  **/
 gboolean
 pango_skip_space (const char **pos)
@@ -382,6 +390,8 @@ pango_skip_space (const char **pos)
  * Leading white space is skipped.
  *
  * Return value: %FALSE if a parse error occurred.
+ *
+ * Deprecated: 1.37
  **/
 gboolean
 pango_scan_word (const char **pos, GString *out)
@@ -425,6 +435,8 @@ pango_scan_word (const char **pos, GString *out)
  * a literal quote. Leading white space outside of quotes is skipped.
  *
  * Return value: %FALSE if a parse error occurred.
+ *
+ * Deprecated: 1.37
  **/
 gboolean
 pango_scan_string (const char **pos, GString *out)
@@ -513,6 +525,8 @@ pango_scan_string (const char **pos, GString *out)
  * Leading white space is skipped.
  *
  * Return value: %FALSE if a parse error occurred.
+ *
+ * Deprecated: 1.37
  **/
 gboolean
 pango_scan_int (const char **pos, int *out)
@@ -676,6 +690,8 @@ parse_int (const char *word,
  *
  * Return value: %TRUE if @str was successfully parsed.
  *
+ * Deprecated: 1.37
+ *
  * Since: 1.16
  **/
 gboolean
diff --git a/pango/pango-utils.h b/pango/pango-utils.h
index 1af5372..40100f6 100644
--- a/pango/pango-utils.h
+++ b/pango/pango-utils.h
@@ -28,16 +28,23 @@
 
 G_BEGIN_DECLS
 
+G_DEPRECATED
 char **  pango_split_file_list (const char *str);
 
+G_DEPRECATED
 char    *pango_trim_string     (const char *str);
+G_DEPRECATED
 gint     pango_read_line      (FILE        *stream,
                               GString     *str);
+G_DEPRECATED
 gboolean pango_skip_space     (const char **pos);
+G_DEPRECATED
 gboolean pango_scan_word      (const char **pos,
                               GString     *out);
+G_DEPRECATED
 gboolean pango_scan_string    (const char **pos,
                               GString     *out);
+G_DEPRECATED
 gboolean pango_scan_int       (const char **pos,
                               int         *out);
 
@@ -52,6 +59,7 @@ void     pango_lookup_aliases (const char   *fontname,
                               int          *n_families);
 #endif /* PANGO_ENABLE_BACKEND */
 
+G_DEPRECATED
 gboolean pango_parse_enum     (GType       type,
                               const char *str,
                               int        *value,