From ef4fa5802b67f612ead021178ddd9b60687c63a7 Mon Sep 17 00:00:00 2001 From: Padraig O'Briain Date: Thu, 20 Jun 2002 08:29:33 +0000 Subject: [PATCH] atk/atkutil.h atk/docs/atk-docs.sgml atk/docs/tmpl/atk-component.sgml * atk/atkutil.h atk/docs/atk-docs.sgml atk/docs/tmpl/atk-component.sgml atk/docs/atkdocument.sgml atk/docs/tmpl/atkeditabletext.sgml atk/docs/tmpl/atkgobjectaccessible.sgml atk/docs/tmpl/atkhyperlink.sgml atk/docs/tmpl/atkhypertext.sgml atk/docs/tmpl/atkimage.sgml atk/docs/atknoopobject.sgml atk/docs/tmpl/atknoopobjectfactory.sgml atk/docs/tmpl/atkobjectfactory.sgml atk/docs/tmpl/atkregistry.sgml atk/docs/tmpl/atkregistry.sgml atk/docs/tmpl/atkrelationset.sgml atk/docs/tmpl/atkselection.sgml atk/docs/tmpl/atkstate.sgml atk/docs/tmpl/atkstateset.sgml atk/docs/tmpl/atkstreamablecontent.sgml atk/docs/tmpl/atktable.sgml atk/docs/tmpl/atktext.sgml atk/docs/tmpl/atkutil.sgml atk/docs/tmpl/atkvalue.sgml Update documentation. --- ChangeLog | 15 +++++++++++++++ atk/atkutil.h | 2 +- docs/atk-docs.sgml | 2 ++ docs/tmpl/atkcomponent.sgml | 2 +- docs/tmpl/atkdocument.sgml | 6 ++++-- docs/tmpl/atkeditabletext.sgml | 2 +- docs/tmpl/atkgobjectaccessible.sgml | 6 ++++++ docs/tmpl/atkhyperlink.sgml | 5 +++-- docs/tmpl/atkhypertext.sgml | 2 +- docs/tmpl/atkimage.sgml | 2 +- docs/tmpl/atknoopobject.sgml | 6 ++++-- docs/tmpl/atknoopobjectfactory.sgml | 6 ++++-- docs/tmpl/atkobjectfactory.sgml | 10 ++++++++-- docs/tmpl/atkregistry.sgml | 3 ++- docs/tmpl/atkrelation.sgml | 7 ++++++- docs/tmpl/atkrelationset.sgml | 2 +- docs/tmpl/atkselection.sgml | 2 +- docs/tmpl/atkstate.sgml | 5 +++-- docs/tmpl/atkstateset.sgml | 5 +++-- docs/tmpl/atkstreamablecontent.sgml | 2 +- docs/tmpl/atktable.sgml | 2 +- docs/tmpl/atktext.sgml | 2 +- docs/tmpl/atkutil.sgml | 5 ++++- docs/tmpl/atkvalue.sgml | 2 +- 24 files changed, 75 insertions(+), 28 deletions(-) diff --git a/ChangeLog b/ChangeLog index 3d9586a..c78825a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,18 @@ +2002-06-20 Padraig O'Briain + + * atk/atkutil.h atk/docs/atk-docs.sgml atk/docs/tmpl/atk-component.sgml + atk/docs/atkdocument.sgml atk/docs/tmpl/atkeditabletext.sgml + atk/docs/tmpl/atkgobjectaccessible.sgml atk/docs/tmpl/atkhyperlink.sgml + atk/docs/tmpl/atkhypertext.sgml atk/docs/tmpl/atkimage.sgml + atk/docs/atknoopobject.sgml atk/docs/tmpl/atknoopobjectfactory.sgml + atk/docs/tmpl/atkobjectfactory.sgml atk/docs/tmpl/atkregistry.sgml + atk/docs/tmpl/atkregistry.sgml atk/docs/tmpl/atkrelationset.sgml + atk/docs/tmpl/atkselection.sgml atk/docs/tmpl/atkstate.sgml + atk/docs/tmpl/atkstateset.sgml atk/docs/tmpl/atkstreamablecontent.sgml + atk/docs/tmpl/atktable.sgml atk/docs/tmpl/atktext.sgml + atk/docs/tmpl/atkutil.sgml atk/docs/tmpl/atkvalue.sgml + Update documentation. + 2002-05-29 Padraig O'Briain * atk/atkregistry.c: diff --git a/atk/atkutil.h b/atk/atkutil.h index 8692386..771235c 100755 --- a/atk/atkutil.h +++ b/atk/atkutil.h @@ -90,7 +90,7 @@ GType atk_util_get_type (void); /** *AtkCoordType: *@ATK_XY_SCREEN: specifies xy coordinates relative to the screen - *@ATK_XY_WINDOW: specifies xy coordinates relative to the widgets + *@ATK_XY_WINDOW: specifies xy coordinates relative to the widget's * top-level window * *Specifies how xy coordinates are to be interpreted. Used by functions such diff --git a/docs/atk-docs.sgml b/docs/atk-docs.sgml index 07773dc..3345b41 100644 --- a/docs/atk-docs.sgml +++ b/docs/atk-docs.sgml @@ -3,6 +3,7 @@ + @@ -34,6 +35,7 @@ &atk-AtkComponent; &atk-AtkDocument; &atk-AtkEditabletext; + &atk-AtkGObjectAccessible; &atk-AtkHyperlink; &atk-AtkHypertext; &atk-AtkImage; diff --git a/docs/tmpl/atkcomponent.sgml b/docs/tmpl/atkcomponent.sgml index 3113221..f5ae969 100644 --- a/docs/tmpl/atkcomponent.sgml +++ b/docs/tmpl/atkcomponent.sgml @@ -2,7 +2,7 @@ AtkComponent -ATK Interface provided by UI components which occupy a physical area on +The ATK interface provided by UI components which occupy a physical area on the screen. diff --git a/docs/tmpl/atkdocument.sgml b/docs/tmpl/atkdocument.sgml index 4a7bb0e..a344719 100644 --- a/docs/tmpl/atkdocument.sgml +++ b/docs/tmpl/atkdocument.sgml @@ -2,11 +2,13 @@ AtkDocument - +The ATK interface which allows access to a DOM associated with on object. - +The AtkDocument interface should be supported by any object that has an +associated document object model (DOM). This interface provides the +standard mechanism allowing an assistive technology access to the DOM. diff --git a/docs/tmpl/atkeditabletext.sgml b/docs/tmpl/atkeditabletext.sgml index 7c1f44d..609d9c9 100644 --- a/docs/tmpl/atkeditabletext.sgml +++ b/docs/tmpl/atkeditabletext.sgml @@ -2,7 +2,7 @@ AtkEditableText -ATK Interface implemented by components containing user-editable text content. +The ATK interface implemented by components containing user-editable text content. diff --git a/docs/tmpl/atkgobjectaccessible.sgml b/docs/tmpl/atkgobjectaccessible.sgml index 9925450..de94f7a 100644 --- a/docs/tmpl/atkgobjectaccessible.sgml +++ b/docs/tmpl/atkgobjectaccessible.sgml @@ -2,10 +2,16 @@ AtkGObjectAccessible +This object class is derived from AtkObject and can be used as a basis +implementing accessible objects. +This object class is derived from AtkObject. It can be used as a basis for +implementing accessible objects for GObjects which are not derived from +GtkWidget. One example of its use is in providing an accessible object +for GnomeCanvasItem in the GAIL library. diff --git a/docs/tmpl/atkhyperlink.sgml b/docs/tmpl/atkhyperlink.sgml index 6a55e80..198a13c 100644 --- a/docs/tmpl/atkhyperlink.sgml +++ b/docs/tmpl/atkhyperlink.sgml @@ -2,11 +2,12 @@ AtkHyperlink - +An ATK object which encapsulates a link or set of links in a hypertext document. - +An ATK object which encapsulates a link or set of links in a hypertext document. +It implements the AtkAction interface. diff --git a/docs/tmpl/atkhypertext.sgml b/docs/tmpl/atkhypertext.sgml index ff6a5fe..9a4a1e2 100644 --- a/docs/tmpl/atkhypertext.sgml +++ b/docs/tmpl/atkhypertext.sgml @@ -2,7 +2,7 @@ AtkHypertext - +The ATK interface which provides standard mechanism for manipulating hyperlinks. diff --git a/docs/tmpl/atkimage.sgml b/docs/tmpl/atkimage.sgml index 749bc09..1e5c709 100644 --- a/docs/tmpl/atkimage.sgml +++ b/docs/tmpl/atkimage.sgml @@ -2,7 +2,7 @@ AtkImage -ATK Interface implemented by components which expose image or pixmap +The ATK Interface implemented by components which expose image or pixmap content on-screen. diff --git a/docs/tmpl/atknoopobject.sgml b/docs/tmpl/atknoopobject.sgml index 05f545e..cab81a0 100644 --- a/docs/tmpl/atknoopobject.sgml +++ b/docs/tmpl/atknoopobject.sgml @@ -2,11 +2,13 @@ AtkNoOpObject - +An AtkObject which purports to implement all ATK interfaces. - +An AtkNoOpObject is an AtkObject which purports to implement all ATK +interfaces. It is the type of AtkObject which is created if an accessible +object is requested for an object type for which no factory type is specified. diff --git a/docs/tmpl/atknoopobjectfactory.sgml b/docs/tmpl/atknoopobjectfactory.sgml index ccac1bb..e49db92 100644 --- a/docs/tmpl/atknoopobjectfactory.sgml +++ b/docs/tmpl/atknoopobjectfactory.sgml @@ -2,11 +2,13 @@ AtkNoOpObjectFactory - +The AtkObjectFactory which creates an AtkNoOpObject. - +The AtkObjectFactory which creates an AtkNoOpObject. An instance of this is +created by an AtkRegistry if no factory type has not been specified to +create an accessible object of a particular type. diff --git a/docs/tmpl/atkobjectfactory.sgml b/docs/tmpl/atkobjectfactory.sgml index 4f4eb38..fa8134b 100644 --- a/docs/tmpl/atkobjectfactory.sgml +++ b/docs/tmpl/atkobjectfactory.sgml @@ -2,15 +2,21 @@ AtkObjectFactory - +The base object class for a factory used to create accessible objects for +objects of a specific GType. - +This class is the base object class for a factory used to create an +accessible object for a specific GType. The function +atk_registry_set_factory_type() is normally called to store +in the registry the factory type to be used to create an accessible of a +particular GType. +AtkRegistry diff --git a/docs/tmpl/atkregistry.sgml b/docs/tmpl/atkregistry.sgml index b561a11..3caa019 100644 --- a/docs/tmpl/atkregistry.sgml +++ b/docs/tmpl/atkregistry.sgml @@ -2,7 +2,8 @@ AtkRegistry - +An object used to store the GType of a factory used to create an accessible +object for an object of a particluar GType. diff --git a/docs/tmpl/atkrelation.sgml b/docs/tmpl/atkrelation.sgml index f0041ae..b841c40 100644 --- a/docs/tmpl/atkrelation.sgml +++ b/docs/tmpl/atkrelation.sgml @@ -2,10 +2,15 @@ AtkRelation - +An object usaed to describe a relation between a object and one or more +other objects. +An AtkRelation describes a relation between the object and one or more +other objects. The actual relations that an object has with other objects +are defined as an AtkRelationSet, which is a set of AtkRelations. + diff --git a/docs/tmpl/atkrelationset.sgml b/docs/tmpl/atkrelationset.sgml index b04560d..deef40a 100644 --- a/docs/tmpl/atkrelationset.sgml +++ b/docs/tmpl/atkrelationset.sgml @@ -2,7 +2,7 @@ AtkRelationSet - +A set of AtkRelations, normally the set of AtkRelations which an AtkObject has. diff --git a/docs/tmpl/atkselection.sgml b/docs/tmpl/atkselection.sgml index d1daf2c..b321184 100644 --- a/docs/tmpl/atkselection.sgml +++ b/docs/tmpl/atkselection.sgml @@ -3,7 +3,7 @@ AtkSelection -ATK Interface implemented by container objects whose #AtkObject children +The ATK interface implemented by container objects whose #AtkObject children can be selected. diff --git a/docs/tmpl/atkstate.sgml b/docs/tmpl/atkstate.sgml index e29a4da..2dcf68b 100644 --- a/docs/tmpl/atkstate.sgml +++ b/docs/tmpl/atkstate.sgml @@ -2,11 +2,12 @@ AtkState - +An AtkState describes a component's particular state. - +An AtkState describes a component's particular state. The actual state of +an component is described by its AtkStateSet, which is a set of AtkStates. diff --git a/docs/tmpl/atkstateset.sgml b/docs/tmpl/atkstateset.sgml index 08afaa7..c06bd66 100644 --- a/docs/tmpl/atkstateset.sgml +++ b/docs/tmpl/atkstateset.sgml @@ -2,11 +2,12 @@ AtkStateSet - +An AtkStateSet determines a component's state set. - +An AtkStateSet determines a component's state set. It is composed of a set +of AtkStates. diff --git a/docs/tmpl/atkstreamablecontent.sgml b/docs/tmpl/atkstreamablecontent.sgml index ee4d96c..8d52d49 100644 --- a/docs/tmpl/atkstreamablecontent.sgml +++ b/docs/tmpl/atkstreamablecontent.sgml @@ -2,7 +2,7 @@ AtkStreamableContent - +The ATK interface which provides access to streamable content. diff --git a/docs/tmpl/atktable.sgml b/docs/tmpl/atktable.sgml index c591e4e..d7ad300 100644 --- a/docs/tmpl/atktable.sgml +++ b/docs/tmpl/atktable.sgml @@ -2,7 +2,7 @@ AtkTable -ATK Interface implemented for UI components which contain tabular or +The ATK interface implemented for UI components which contain tabular or row/column information. diff --git a/docs/tmpl/atktext.sgml b/docs/tmpl/atktext.sgml index 4c64847..3001200 100644 --- a/docs/tmpl/atktext.sgml +++ b/docs/tmpl/atktext.sgml @@ -2,7 +2,7 @@ AtkText -ATK Interface provided by components with text content. +The ATK interface implemented by components with text content. diff --git a/docs/tmpl/atkutil.sgml b/docs/tmpl/atkutil.sgml index fd370eb..6ce5e0c 100644 --- a/docs/tmpl/atkutil.sgml +++ b/docs/tmpl/atkutil.sgml @@ -2,10 +2,13 @@ AtkUtil - +This is a utility class which supports the adding and removal of event listeners. +This is a utility class which supports the adding and removal of event +listeners. The adding and removing of the listeners must be done in the +same thread. The file also contains a number of utility functions. diff --git a/docs/tmpl/atkvalue.sgml b/docs/tmpl/atkvalue.sgml index 0e17efd..0dc59a3 100644 --- a/docs/tmpl/atkvalue.sgml +++ b/docs/tmpl/atkvalue.sgml @@ -2,7 +2,7 @@ AtkValue -ATK Interface implemented by valuators and components which display or +The ATK interface implemented by valuators and components which display or select a value from a bounded range of values. -- 2.7.4