atkdocument: deprecation of some methods

atk_document_get_document, atk_document_get_document_type and their
equivalent virtuals were deprecated. Documentation properly updated.

At least atk_document_get_document_type seems to be announced as
deprecated since a long time ago. At least firefox code (in form
of comments) mention that. The case of atk_document_get_document
seems worse, as it doesn't makes too much sense. None of them
are used at at-spi at all.

1 files changed, 7 insertions, 0 deletions

diff --git a/atk/atkdocument.c b/atk/atkdocument.c
index 35d7bfe..f1515bb 100755
--- a/atk/atkdocument.c
+++ b/atk/atkdocument.c
@@ -165,6 +165,9 @@ atk_document_base_init (AtkDocumentIface *class)
  *
  * Gets a string indicating the document type.
  *
+ * Deprecated: Since 2.12. Please use atk_document_get_attributes() to
+ * ask for the document type if it applies.
+ *
  * Returns: a string indicating the document type
  **/
 const gchar*
@@ -194,6 +197,10 @@ atk_document_get_document_type (AtkDocument *document)
  * up to the caller to check atk_document_get_type to determine
  * how to cast this pointer.
  *
+ * Deprecated: Since 2.12. @document is already a representation of
+ * the document. Use it directly, or one of his children, as an
+ * instance of the DOM.
+ *
  * Returns: (transfer none): a %gpointer that points to an instance of the DOM.
  **/
 gpointer