doc: improve ATK_TEXT_ATTR documentation

[platform/upstream/atk.git] / atk / atkdocument.c

diff --git a/atk/atkdocument.c b/atk/atkdocument.c
index 35d7bfe..f1515bb 100755 (executable)
--- 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