summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rwxr-xr-xatk/atkdocument.c7
-rwxr-xr-xatk/atkdocument.h17
2 files changed, 23 insertions, 1 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
diff --git a/atk/atkdocument.h b/atk/atkdocument.h
index 874e89d..9ad537d 100755
--- a/atk/atkdocument.h
+++ b/atk/atkdocument.h
@@ -48,8 +48,20 @@ typedef struct _AtkDocumentIface AtkDocumentIface;
/**
* AtkDocumentIface:
+ * @get_document_type: gets a string indicating the document
+ * type. This virtual function is deprecated since 2.12 and it
+ * should not be overriden.
+ * @get_document: a #GObject instance that implements
+ * AtkDocumentIface. This virtual method is deprecated since 2.12
+ * and it should not be overriden.
* @get_document_locale: gets locale. This virtual function is
- * deprecated since 2.7.90 and it should not be overriden.
+ * deprecated since 2.7.90 and it should not be overriden.
+ * @get_document_attributes: gets an AtkAttributeSet which describes
+ * document-wide attributes as name-value pairs.
+ * @get_document_attribute_value: returns a string value assocciated
+ * with the named attribute for this document, or NULL
+ * @set_document_attribute: sets the value of an attribute. Returns
+ * TRUE on success, FALSE otherwise
*/
struct _AtkDocumentIface
{
@@ -68,7 +80,10 @@ struct _AtkDocumentIface
GType atk_document_get_type (void);
+G_DEPRECATED
const gchar* atk_document_get_document_type (AtkDocument *document);
+
+G_DEPRECATED
gpointer atk_document_get_document (AtkDocument *document);
G_DEPRECATED