[gxml] xlibxml: Deprecated

[Daniel Espinosa Ortiz <despinosa src gnome org>]

commit c2d81e1c3163a7160bde71091d7c8e75cf4e570b
Author: Daniel Espinosa <esodan gmail com>
Date:   Thu May 11 11:39:49 2017 -0500

    xlibxml: Deprecated

 gxml/Notation.vala    |    5 ++++
 gxml/meson.build      |    2 +
 gxml/xlibxml.c        |   62 ++++++++++++++++++++++++++++++++++++++++++++++++-
 vapi/xlibxml-1.0.vapi |   14 ++++++++++-
 4 files changed, 81 insertions(+), 2 deletions(-)
---
diff --git a/gxml/Notation.vala b/gxml/Notation.vala
index ea7bb10..e8a0b87 100644
--- a/gxml/Notation.vala
+++ b/gxml/Notation.vala
@@ -38,3 +38,8 @@ public interface GXml.Notation : Object, GXml.Node
   public abstract string? public_id { get; }
   public abstract string? external_id { get; }
 }
+
+/**
+ * Dummy definition for entity.
+ */
+public interface GXml.Entity : Object, GXml.Node {}
diff --git a/gxml/meson.build b/gxml/meson.build
index ea57279..3471fc2 100644
--- a/gxml/meson.build
+++ b/gxml/meson.build
@@ -119,6 +119,8 @@ valasources = files ([
 ])
 
 sources = files ([
+       'xlibxml.c',
+       'xlibxml.h'
 ])
 
 inc_gxmlh = include_directories ('.')
diff --git a/gxml/xlibxml.c b/gxml/xlibxml.c
index e25ab69..43590e8 100644
--- a/gxml/xlibxml.c
+++ b/gxml/xlibxml.c
@@ -20,13 +20,22 @@
  */
 
 #include<gxml/xlibxml.h>
-
+/**
+ * gxml_doc_get_intsubset_entities:
+ *
+ * Deprecated: 0.15
+ */
 void* gxml_doc_get_intsubset_entities (xmlDoc *doc)
 {
   g_return_val_if_fail (doc != NULL, NULL);
   return doc->intSubset->entities;
 }
 
+/**
+ * gxml_validate_name:
+ *
+ * Deprecated: 0.15
+ */
 gint gxml_validate_name (xmlChar* name, int space)
 {
   g_return_val_if_fail (name != NULL, -1);
@@ -44,26 +53,52 @@ xmlErrorPtr gxml_parser_context_get_last_error (void* ctx)
   return gxml_context_get_last_error (ctx);
 }
 
+/**
+ * gxml_context_get_last_error:
+ *
+ * Deprecated: 0.15
+ */
 xmlErrorPtr gxml_context_get_last_error (void* ctx)
 {
   g_return_val_if_fail (ctx != NULL, NULL);
   return xmlCtxtGetLastError (ctx);
 }
 
+/**
+ * gxml_context_reset_last_error:
+ *
+ * Deprecated: 0.15
+ */
 void gxml_context_reset_last_error (void* ctx)
 {
   xmlCtxtResetLastError (ctx);
 }
 
+/**
+ * gxml_get_last_error:
+ *
+ * Deprecated: 0.15
+ */
 xmlErrorPtr gxml_get_last_error ()
 {
   return xmlGetLastError ();
 }
 
+/**
+ * gxml_reset_last_error:
+ *
+ * Deprecated: 0.15
+ */
 void gxml_reset_last_error ()
 {
   xmlResetLastError ();
 }
+
+/**
+ * gxml_doc_get_ns_list:
+ *
+ * Deprecated: 0.15
+ */
 xmlNsPtr* gxml_doc_get_ns_list (xmlDoc* doc, xmlNode* node)
 {
   g_return_val_if_fail (doc != NULL, NULL);
@@ -71,18 +106,33 @@ xmlNsPtr* gxml_doc_get_ns_list (xmlDoc* doc, xmlNode* node)
   return xmlGetNsList (doc, node);
 }
 
+/**
+ * gxml_new_text_writer_doc:
+ *
+ * Deprecated: 0.15
+ */
 xmlTextWriterPtr gxml_new_text_writer_doc (xmlDoc** doc)
 {
   g_return_val_if_fail (doc != NULL, NULL);
   return xmlNewTextWriterDoc (doc, 0);
 }
 
+/**
+ * gxml_new_text_writer_memory:
+ *
+ * Deprecated: 0.15
+ */
 xmlTextWriterPtr gxml_new_text_writer_memory (xmlBufferPtr buffer, gint compression)
 {
   g_return_val_if_fail (buffer != NULL, NULL);
   return xmlNewTextWriterMemory (buffer, compression);
 }
 
+/**
+ * gxml_text_writer_write_cdata:
+ *
+ * Deprecated: 0.15
+ */
 gint gxml_text_writer_write_cdata (xmlTextWriterPtr tw, const xmlChar* text)
 {
   g_return_val_if_fail (tw != NULL, -1);
@@ -90,6 +140,11 @@ gint gxml_text_writer_write_cdata (xmlTextWriterPtr tw, const xmlChar* text)
   return xmlTextWriterWriteCDATA (tw, text);
 }
 
+/**
+ * gxml_text_writer_write_pi:
+ *
+ * Deprecated: 0.15
+ */
 gint gxml_text_writer_write_pi (xmlTextWriterPtr tw, const xmlChar* target, const xmlChar* data)
 {
   g_return_val_if_fail (tw != NULL, -1);
@@ -99,6 +154,11 @@ gint gxml_text_writer_write_pi (xmlTextWriterPtr tw, const xmlChar* target, cons
 }
 
 
+/**
+ * gxml_copy_props:
+ *
+ * Deprecated: 0.15
+ */
 void gxml_copy_props (xmlNodePtr src, xmlNodePtr dst)
 {
        g_return_if_fail (src != NULL);
diff --git a/vapi/xlibxml-1.0.vapi b/vapi/xlibxml-1.0.vapi
index c184136..5485a30 100644
--- a/vapi/xlibxml-1.0.vapi
+++ b/vapi/xlibxml-1.0.vapi
@@ -20,37 +20,49 @@
  */
 
 /**
- * Utility functions not present in libxml-2.0 bindings to be used internaly.
+ * Deprecated utility functions.
  *
  * Don't use this namespace's functions in your code. Instead, use GXml's public API.
  */
 [CCode (cheader_filename = "gxml/xlibxml.h")]
 namespace Xmlx {
   [CCode (cname = "gxml_doc_get_intsubset_entities", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static Xml.HashTable doc_get_dtd_entities (Xml.Doc *doc);
   [CCode (cname = "gxml_validate_name", cheader_filename = "gxml//xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static int validate_name ([CCode (type = "xmlChar*")] string name, int space);
   [CCode (cname = "gxml_parser_context_get_last_error", cheader_filename = "gxml/xlibxml.h")]
   [Version (deprecated=true, replacement = "context_get_last_error", deprecated_since = "0.8.1")]
   public static Xml.Error* parser_context_get_last_error (Xml.ParserCtxt ctx);
   [CCode (cname = "gxml_context_get_last_error", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static Xml.Error* context_get_last_error (Xml.ParserCtxt ctx);
   [CCode (cname = "gxml_context_reset_last_error", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static void context_reset_last_error (Xml.ParserCtxt ctx);
   [CCode (cname = "gxml_get_last_error", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static Xml.Error* get_last_error ();
   [CCode (cname = "gxml_reset_last_error", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static void reset_last_error ();
   [CCode (cname = "gxml_doc_get_ns_list", array_null_terminated = true, cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static Xml.Ns*[] doc_get_ns_list (Xml.Doc* doc, Xml.Node* node);
   [CCode (cname = "gxml_new_text_writer_doc", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static Xml.TextWriter new_text_writer_doc (ref Xml.Doc doc);
   [CCode (cname = "gxml_new_text_writer_memory", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static Xml.TextWriter new_text_writer_memory (Xml.Buffer buffer, int compression);
   [CCode (cname = "gxml_text_writer_write_cdata", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static int text_writer_write_cdata (Xml.TextWriter tw, string text);
   [CCode (cname = "gxml_text_writer_write_pi", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static int text_writer_write_pi (Xml.TextWriter tw, string target, string data);
   [CCode (cname = "gxml_copy_props", cheader_filename = "gxml/xlibxml.h")]
+  [Version (deprecated="true", since="0.15")]
   public static int copy_props (Xml.Node src, Xml.Node dst);
 }