GNOME.org
 

[atkmm] Regenerate atk_docs.xml and the .defs files

commit 8fb07dcbda5946432d60d6020126af513607f345
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date:   Mon Sep 4 20:04:16 2017 +0200

    Regenerate atk_docs.xml and the .defs files
    
    and add some substitute_enumerator_name elements to atk_docs_override.xml.

 atk/src/atk_docs.xml          |  120 +++++++++++++++++++++++++++++-
 atk/src/atk_docs_override.xml |    4 +-
 atk/src/atk_enums.defs        |   14 +++-
 atk/src/atk_methods.defs      |  163 +++++++++++++++++++++--------------------
 atk/src/atk_signals.defs      |   19 ++++-
 5 files changed, 228 insertions(+), 92 deletions(-)
---
diff --git a/atk/src/atk_docs.xml b/atk/src/atk_docs.xml
index 448ac76..7969461 100644
--- a/atk/src/atk_docs.xml
+++ b/atk/src/atk_docs.xml
@@ -133,6 +133,16 @@ The signal link-activated is emitted when a link is activated.
 <return></return>
 </signal>
 
+<property name="AtkHyperlink:selected-link">
+<description>
+Selected link
+
+Deprecated: 1.8: Please use ATK_STATE_FOCUSABLE for all links, and
+ATK_STATE_FOCUSED for focused links.
+
+</description>
+</property>
+
 <enum name="AtkHyperlinkStateFlags">
 <description>
 Describes the type of link
@@ -374,6 +384,66 @@ appearance of the object changed.
 <return></return>
 </signal>
 
+<property name="AtkObject:accessible-table-caption">
+<description>
+Table caption.
+
+Deprecated: Since 1.3. Use table-caption-object instead.
+
+</description>
+</property>
+
+<property name="AtkObject:accessible-table-column-description">
+<description>
+Accessible table column description.
+
+Deprecated: Since 2.12. Use atk_table_get_column_description()
+and atk_table_set_column_description() instead.
+
+</description>
+</property>
+
+<property name="AtkObject:accessible-table-column-header">
+<description>
+Accessible table column header.
+
+Deprecated: Since 2.12. Use atk_table_get_column_header() and
+atk_table_set_column_header() instead.
+
+</description>
+</property>
+
+<property name="AtkObject:accessible-table-row-description">
+<description>
+Accessible table row description.
+
+Deprecated: Since 2.12. Use atk_table_get_row_description() and
+atk_table_set_row_description() instead.
+
+</description>
+</property>
+
+<property name="AtkObject:accessible-table-row-header">
+<description>
+Accessible table row header.
+
+Deprecated: Since 2.12. Use atk_table_get_row_header() and
+atk_table_set_row_header() instead.
+
+</description>
+</property>
+
+<property name="AtkObject:accessible-value">
+<description>
+Numeric value of this object, in case being and AtkValue.
+
+Deprecated: Since 2.12. Use atk_value_get_value_and_text() to get
+the value, and value-changed signal to be notified on their value
+changes.
+
+</description>
+</property>
+
 <enum name="AtkRelationType">
 <description>
 Describes the type of the relation
@@ -429,7 +499,7 @@ another's content.
 </parameter_description>
 </parameter>
 <parameter name="ATK_RELATION_EMBEDDED_BY">
-<parameter_description> Inverse of %ATK_RELATION_EMBEDS, indicates that
+<parameter_description> Reciprocal of %ATK_RELATION_EMBEDS, indicates that
 this object's content is visualy embedded in another object.
 </parameter_description>
 </parameter>
@@ -442,17 +512,57 @@ this object's content is visualy embedded in another object.
 </parameter_description>
 </parameter>
 <parameter name="ATK_RELATION_DESCRIBED_BY">
-<parameter_description> Indicates that another object provides descriptive information about this object; 
more verbose than ATK_RELATION_LABELLED_BY.
+<parameter_description> Reciprocal of %ATK_RELATION_DESCRIPTION_FOR. Indicates that one
+or more target objects provide descriptive information about this object. This relation
+type is most appropriate for information that is not essential as its presentation may
+be user-configurable and/or limited to an on-demand mechanism such as an assistive
+technology command. For brief, essential information such as can be found in a widget's
+on-screen label, use %ATK_RELATION_LABELLED_BY. For an on-screen error message, use
+%ATK_RELATION_ERROR_MESSAGE. For lengthy extended descriptive information contained in
+an on-screen object, consider using %ATK_RELATION_DETAILS as assistive technologies may
+provide a means for the user to navigate to objects containing detailed descriptions so
+that their content can be more closely reviewed.
 </parameter_description>
 </parameter>
 <parameter name="ATK_RELATION_DESCRIPTION_FOR">
-<parameter_description> Indicates that an object provides descriptive information about another object; more 
verbose than ATK_RELATION_LABEL_FOR.
+<parameter_description> Reciprocal of %ATK_RELATION_DESCRIBED_BY. Indicates that this
+object provides descriptive information about the target object(s). See also
+%ATK_RELATION_DETAILS_FOR and %ATK_RELATION_ERROR_FOR.
 </parameter_description>
 </parameter>
 <parameter name="ATK_RELATION_NODE_PARENT_OF">
 <parameter_description> Indicates an object is a cell in a treetable and is expanded to display other cells 
in the same column.
 </parameter_description>
 </parameter>
+<parameter name="ATK_RELATION_DETAILS">
+<parameter_description> Reciprocal of %ATK_RELATION_DETAILS_FOR. Indicates that this object
+has a detailed or extended description, the contents of which can be found in the target
+object(s). This relation type is most appropriate for information that is sufficiently
+lengthy as to make navigation to the container of that information desirable. For less
+verbose information suitable for announcement only, see %ATK_RELATION_DESCRIBED_BY. If
+the detailed information describes an error condition, %ATK_RELATION_ERROR_FOR should be
+used instead. @Since: ATK-2.26.
+</parameter_description>
+</parameter>
+<parameter name="ATK_RELATION_DETAILS_FOR">
+<parameter_description> Reciprocal of %ATK_RELATION_DETAILS. Indicates that this object
+provides a detailed or extended description about the target object(s). See also
+%ATK_RELATION_DESCRIPTION_FOR and %ATK_RELATION_ERROR_FOR. @Since: ATK-2.26.
+</parameter_description>
+</parameter>
+<parameter name="ATK_RELATION_ERROR_MESSAGE">
+<parameter_description> Reciprocal of %ATK_RELATION_ERROR_FOR. Indicates that this object
+has one or more errors, the nature of which is described in the contents of the target
+object(s). Objects that have this relation type should also contain %ATK_STATE_INVALID_ENTRY
+in their #AtkStateSet. @Since: ATK-2.26.
+</parameter_description>
+</parameter>
+<parameter name="ATK_RELATION_ERROR_FOR">
+<parameter_description> Reciprocal of %ATK_RELATION_ERROR_MESSAGE. Indicates that this object
+contains an error message describing an invalid condition in the target object(s). @Since:
+ATK_2.26.
+</parameter_description>
+</parameter>
 <parameter name="ATK_RELATION_LAST_DEFINED">
 <parameter_description> Not used, this value indicates the end of the enumeration.
 </parameter_description>
@@ -881,7 +991,7 @@ Describes the text attributes supported
 <enum name="AtkTextBoundary">
 <description>
 Text boundary types used for specifying boundaries for regions of text.
-This enumerationis deprecated since 2.9.4 and should not be used. Use
+This enumeration is deprecated since 2.9.4 and should not be used. Use
 AtkTextGranularity with #atk_text_get_string_at_offset instead.
 
 </description>
@@ -6433,7 +6543,7 @@ Gets the description string describing the #AtkValueType @value_type.
 
 </description>
 <parameters>
-<parameter name="role">
+<parameter name="value_type">
 <parameter_description> The #AtkValueType whose name is required
 </parameter_description>
 </parameter>
diff --git a/atk/src/atk_docs_override.xml b/atk/src/atk_docs_override.xml
index ee9cd62..071f6c3 100644
--- a/atk/src/atk_docs_override.xml
+++ b/atk/src/atk_docs_override.xml
@@ -1,6 +1,8 @@
 <root>
 <substitute_type_name from="GObject" to="Glib::Object" />
-<substitute_enumerator_name from_prefix="ATK_RELATION_" to_prefix="Atk::RelationType::" />
+<substitute_enumerator_name from_prefix="ATK_RELATION_" to_prefix="Atk::Relation::Type::" />
+<substitute_enumerator_name from="ATK_RELATION_NULL" to="Atk::Relation::Type::NONE" />
+<substitute_enumerator_name from_prefix="ATK_STATE_" to_prefix="Atk::StateType::" />
 <!-- These are preprocessor defines. Don't substitute. -->
 <substitute_enumerator_name from_prefix="ATK_ATTRIBUTE_" to_prefix="ATK_ATTRIBUTE_" />
 
diff --git a/atk/src/atk_enums.defs b/atk/src/atk_enums.defs
index dc2d393..d059ec2 100644
--- a/atk/src/atk_enums.defs
+++ b/atk/src/atk_enums.defs
@@ -141,6 +141,7 @@
 ;;   ATK_ROLE_MATH_ROOT,
 ;;   ATK_ROLE_SUBSCRIPT,
 ;;   ATK_ROLE_SUPERSCRIPT,
+;;   ATK_ROLE_FOOTNOTE,
 ;;   ATK_ROLE_LAST_DEFINED
 ;; } AtkRole;
 
@@ -270,7 +271,8 @@
     '("math-root" "ATK_ROLE_MATH_ROOT" "119")
     '("subscript" "ATK_ROLE_SUBSCRIPT" "120")
     '("superscript" "ATK_ROLE_SUPERSCRIPT" "121")
-    '("last-defined" "ATK_ROLE_LAST_DEFINED" "122")
+    '("footnote" "ATK_ROLE_FOOTNOTE" "122")
+    '("last-defined" "ATK_ROLE_LAST_DEFINED" "123")
   )
 )
 
@@ -324,6 +326,10 @@
 ;;   ATK_RELATION_DESCRIBED_BY,
 ;;   ATK_RELATION_DESCRIPTION_FOR,
 ;;   ATK_RELATION_NODE_PARENT_OF,
+;;   ATK_RELATION_DETAILS,
+;;   ATK_RELATION_DETAILS_FOR,
+;;   ATK_RELATION_ERROR_MESSAGE,
+;;   ATK_RELATION_ERROR_FOR,
 ;;   ATK_RELATION_LAST_DEFINED
 ;; } AtkRelationType;
 
@@ -348,7 +354,11 @@
     '("described-by" "ATK_RELATION_DESCRIBED_BY" "14")
     '("description-for" "ATK_RELATION_DESCRIPTION_FOR" "15")
     '("node-parent-of" "ATK_RELATION_NODE_PARENT_OF" "16")
-    '("last-defined" "ATK_RELATION_LAST_DEFINED" "17")
+    '("details" "ATK_RELATION_DETAILS" "17")
+    '("details-for" "ATK_RELATION_DETAILS_FOR" "18")
+    '("error-message" "ATK_RELATION_ERROR_MESSAGE" "19")
+    '("error-for" "ATK_RELATION_ERROR_FOR" "20")
+    '("last-defined" "ATK_RELATION_LAST_DEFINED" "21")
   )
 )
 
diff --git a/atk/src/atk_methods.defs b/atk/src/atk_methods.defs
index f774237..73541f9 100644
--- a/atk/src/atk_methods.defs
+++ b/atk/src/atk_methods.defs
@@ -326,6 +326,7 @@
     '("math-root" "ATK_ROLE_MATH_ROOT")
     '("subscript" "ATK_ROLE_SUBSCRIPT")
     '("superscript" "ATK_ROLE_SUPERSCRIPT")
+    '("footnote" "ATK_ROLE_FOOTNOTE")
     '("last-defined" "ATK_ROLE_LAST_DEFINED")
   )
 )
@@ -368,6 +369,10 @@
     '("described-by" "ATK_RELATION_DESCRIBED_BY")
     '("description-for" "ATK_RELATION_DESCRIPTION_FOR")
     '("node-parent-of" "ATK_RELATION_NODE_PARENT_OF")
+    '("details" "ATK_RELATION_DETAILS")
+    '("details-for" "ATK_RELATION_DETAILS_FOR")
+    '("error-message" "ATK_RELATION_ERROR_MESSAGE")
+    '("error-for" "ATK_RELATION_ERROR_FOR")
     '("last-defined" "ATK_RELATION_LAST_DEFINED")
   )
 )
@@ -906,70 +911,6 @@
 
 
 
-;; From atk-enum-types.h
-
-(define-function atk_hyperlink_state_flags_get_type
-  (c-name "atk_hyperlink_state_flags_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_role_get_type
-  (c-name "atk_role_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_layer_get_type
-  (c-name "atk_layer_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_relation_type_get_type
-  (c-name "atk_relation_type_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_state_type_get_type
-  (c-name "atk_state_type_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_text_attribute_get_type
-  (c-name "atk_text_attribute_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_text_boundary_get_type
-  (c-name "atk_text_boundary_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_text_granularity_get_type
-  (c-name "atk_text_granularity_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_text_clip_type_get_type
-  (c-name "atk_text_clip_type_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_key_event_type_get_type
-  (c-name "atk_key_event_type_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_coord_type_get_type
-  (c-name "atk_coord_type_get_type")
-  (return-type "GType")
-)
-
-(define-function atk_value_type_get_type
-  (c-name "atk_value_type_get_type")
-  (return-type "GType")
-)
-
-
-
 ;; From atkgobjectaccessible.h
 
 (define-function atk_gobject_accessible_get_type
@@ -1159,10 +1100,6 @@
 
 
 
-;; From atkmarshal.h
-
-
-
 ;; From atkmisc.h
 
 (define-function atk_misc_get_type
@@ -2812,6 +2749,83 @@
 
 
 
+;; From atkwindow.h
+
+(define-function atk_window_get_type
+  (c-name "atk_window_get_type")
+  (return-type "GType")
+)
+
+
+
+;; From atk-enum-types.h
+
+(define-function atk_hyperlink_state_flags_get_type
+  (c-name "atk_hyperlink_state_flags_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_role_get_type
+  (c-name "atk_role_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_layer_get_type
+  (c-name "atk_layer_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_relation_type_get_type
+  (c-name "atk_relation_type_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_state_type_get_type
+  (c-name "atk_state_type_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_text_attribute_get_type
+  (c-name "atk_text_attribute_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_text_boundary_get_type
+  (c-name "atk_text_boundary_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_text_granularity_get_type
+  (c-name "atk_text_granularity_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_text_clip_type_get_type
+  (c-name "atk_text_clip_type_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_key_event_type_get_type
+  (c-name "atk_key_event_type_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_coord_type_get_type
+  (c-name "atk_coord_type_get_type")
+  (return-type "GType")
+)
+
+(define-function atk_value_type_get_type
+  (c-name "atk_value_type_get_type")
+  (return-type "GType")
+)
+
+
+
+;; From atkmarshal.h
+
+
+
 ;; From atkversion.h
 
 (define-function atk_get_major_version
@@ -2840,16 +2854,3 @@
 )
 
 
-
-;; From atkwindow.h
-
-(define-function atk_window_get_type
-  (c-name "atk_window_get_type")
-  (return-type "GType")
-)
-
-
-
-;; From stamp-atkmarshal.h
-
-
diff --git a/atk/src/atk_signals.defs b/atk/src/atk_signals.defs
index 0d2a4a3..51b3668 100644
--- a/atk/src/atk_signals.defs
+++ b/atk/src/atk_signals.defs
@@ -19,7 +19,6 @@
   )
 )
 
-;; Manually changed parameter type from gpointer to AtkPropertyValues*
 (define-signal property-change
   (of-object "AtkObject")
   (return-type "void")
@@ -45,7 +44,6 @@
   (when "last")
 )
 
-;; Manually changed parameter type from gpointer to gpointer*
 (define-signal active-descendant-changed
   (of-object "AtkObject")
   (return-type "void")
@@ -58,10 +56,11 @@
 (define-property accessible-name
   (of-object "AtkObject")
   (prop-type "GParamString")
-  (docs "Object instance's name formatted for assistive technology access")
+  (docs "Object instance’s name formatted for assistive technology access")
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "")
 )
 
 (define-property accessible-description
@@ -71,6 +70,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "")
 )
 
 (define-property accessible-parent
@@ -89,6 +89,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "0")
 )
 
 (define-property accessible-role
@@ -98,6 +99,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "66")
 )
 
 (define-property accessible-component-layer
@@ -107,6 +109,7 @@
   (readable #t)
   (writable #f)
   (construct-only #f)
+  (default-value "0")
 )
 
 (define-property accessible-component-mdi-zorder
@@ -116,6 +119,7 @@
   (readable #t)
   (writable #f)
   (construct-only #f)
+  (default-value "-2147483648")
 )
 
 (define-property accessible-table-caption
@@ -125,6 +129,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "")
 )
 
 (define-property accessible-table-column-description
@@ -134,6 +139,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "")
 )
 
 (define-property accessible-table-column-header
@@ -152,6 +158,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "")
 )
 
 (define-property accessible-table-row-header
@@ -188,6 +195,7 @@
   (readable #t)
   (writable #f)
   (construct-only #f)
+  (default-value "0")
 )
 
 ;; From AtkComponent
@@ -220,6 +228,7 @@
   (readable #t)
   (writable #f)
   (construct-only #f)
+  (default-value "FALSE")
 )
 
 (define-property number-of-anchors
@@ -229,6 +238,7 @@
   (readable #t)
   (writable #f)
   (construct-only #f)
+  (default-value "0")
 )
 
 (define-property end-index
@@ -238,6 +248,7 @@
   (readable #t)
   (writable #f)
   (construct-only #f)
+  (default-value "0")
 )
 
 (define-property start-index
@@ -247,6 +258,7 @@
   (readable #t)
   (writable #f)
   (construct-only #f)
+  (default-value "0")
 )
 
 ;; From AtkHyperlinkImpl
@@ -472,6 +484,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
+  (default-value "ATK_RELATION_NULL")
 )
 
 (define-property target
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]