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

2 files changed, 24 insertions, 0 deletions

diff --git a/pango/pango-utils.c b/pango/pango-utils.c
index eb01fa61..ecbea54f 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 1af5372b..40100f6a 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,