diff options
author | Aline Bessa <alibezz@gmail.com> | 2011-07-27 01:26:45 -0300 |
---|---|---|
committer | Mike Gorse <mgorse@novell.com> | 2011-08-23 22:43:02 -0500 |
commit | 6b7ebe6fc5a5e1d001600cff44acca8fd352fd6f (patch) | |
tree | b932acd4a13ba4f6dbc87b8f6e9c29a4619c81b2 | |
parent | 31d7981f78cfc7c1c8c40da0c5e402790b9e4c90 (diff) | |
download | at-spi2-core-6b7ebe6fc5a5e1d001600cff44acca8fd352fd6f.tar.gz |
Improving atspi-document.c documentation
-rw-r--r-- | atspi/atspi-document.c | 24 | ||||
-rw-r--r-- | doc/libatspi/tmpl/libatspi-unused.sgml | 6 |
2 files changed, 16 insertions, 14 deletions
diff --git a/atspi/atspi-document.c b/atspi/atspi-document.c index 87feb044..8353689a 100644 --- a/atspi/atspi-document.c +++ b/atspi/atspi-document.c @@ -25,9 +25,9 @@ /** * atspi_document_get_locale: - * @obj: a pointer to the #Accessible object on which to operate. + * @obj: a pointer to the #AtspiDocument object on which to operate. * - * Gets the locale associated with the document's content. + * Gets the locale associated with the document's content, * e.g. the locale for LOCALE_TYPE_MESSAGES. * * Returns: a string compliant with the POSIX standard for locale description. @@ -46,14 +46,12 @@ atspi_document_get_locale (AtspiDocument *obj, GError **error) /** * atspi_document_get_attribute_value: - * @obj: a pointer to the #Accessible object on which to operate. - * @attribute: a string indicating the name of a specific attribute + * @obj: a pointer to the #AtspiDocument object on which to operate. + * @attribute: a string indicating the name of a specific attribute. * * Gets the value of a single attribute, if specified for the document as a whole. * - * (name-value pair) being queried. - * - * Returns a string corresponding to the value of the specified attribute, or + * Returns: a string corresponding to the value of the specified attribute, or * an empty string if the attribute is unspecified for the object. **/ gchar * @@ -76,15 +74,13 @@ atspi_document_get_attribute_value (AtspiDocument *obj, /** * atspi_document_get_attributes: - * @obj: a pointer to the #Accessible object on which to operate. + * @obj: a pointer to the #AtspiDocument object on which to operate. * - * Gets all attributes specified for a document as a whole. - * - * For attributes which change within - * the document content, see atspi_text_get_attribute_run instead. + * Gets all constant attributes for the document as a whole. For attributes + * that change within the document content, see @atspi_text_get_attribute_run instead. * - * Returns: (element-type gchar* gchar*) (transfer full): an ::AttributeSet - * containing the attributes of the document, as name-value pairs. + * Returns: (element-type gchar* gchar*) (transfer full): a #GHashTable + * containing the constant attributes of the document, as name-value pairs. **/ GHashTable * atspi_document_get_attributes (AtspiDocument *obj, GError **error) diff --git a/doc/libatspi/tmpl/libatspi-unused.sgml b/doc/libatspi/tmpl/libatspi-unused.sgml index 2f0d56d8..fc5e21a6 100644 --- a/doc/libatspi/tmpl/libatspi-unused.sgml +++ b/doc/libatspi/tmpl/libatspi-unused.sgml @@ -59,3 +59,9 @@ @path: @Returns: +<!-- ##### FUNCTION atspi_document_get_type ##### --> +<para> + +</para> + + |