doc: add an overview
[platform/upstream/atk.git] / docs / atk-docs.sgml
1 <?xml version="1.0"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3           "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4   <!ENTITY atk-AtkAction SYSTEM "xml/atkaction.xml">
5   <!ENTITY atk-AtkComponent SYSTEM "xml/atkcomponent.xml">
6   <!ENTITY atk-AtkDocument SYSTEM "xml/atkdocument.xml">
7   <!ENTITY atk-AtkEditabletext SYSTEM "xml/atkeditabletext.xml">
8   <!ENTITY atk-AtkGObjectAccessible SYSTEM "xml/atkgobjectaccessible.xml">
9   <!ENTITY atk-AtkHyperlink SYSTEM "xml/atkhyperlink.xml">
10   <!ENTITY atk-AtkHyperlinkImpl SYSTEM "xml/atkhyperlinkimpl.xml">
11   <!ENTITY atk-AtkHypertext SYSTEM "xml/atkhypertext.xml">
12   <!ENTITY atk-AtkImage SYSTEM "xml/atkimage.xml">
13   <!ENTITY atk-AtkMisc SYSTEM "xml/atkmisc.xml">
14   <!ENTITY atk-AtkNoOpObject SYSTEM "xml/atknoopobject.xml">
15   <!ENTITY atk-AtkNoOpObjectFactory SYSTEM "xml/atknoopobjectfactory.xml">
16   <!ENTITY atk-AtkPlug SYSTEM "xml/atkplug.xml">
17   <!ENTITY atk-AtkObject SYSTEM "xml/atkobject.xml">
18   <!ENTITY atk-AtkObjectFactory SYSTEM "xml/atkobjectfactory.xml">
19   <!ENTITY atk-AtkRegistry SYSTEM "xml/atkregistry.xml">
20   <!ENTITY atk-AtkRelation SYSTEM "xml/atkrelation.xml">
21   <!ENTITY atk-AtkRelationSet SYSTEM "xml/atkrelationset.xml">
22   <!ENTITY atk-AtkSelection SYSTEM "xml/atkselection.xml">
23   <!ENTITY atk-AtkSocket SYSTEM "xml/atksocket.xml">
24   <!ENTITY atk-AtkState SYSTEM "xml/atkstate.xml">
25   <!ENTITY atk-AtkStateSet SYSTEM "xml/atkstateset.xml">
26   <!ENTITY atk-AtkStreamableContent SYSTEM "xml/atkstreamablecontent.xml">
27   <!ENTITY atk-AtkTable SYSTEM "xml/atktable.xml">
28   <!ENTITY atk-AtkTableCell SYSTEM "xml/atktablecell.xml">
29   <!ENTITY atk-AtkText SYSTEM "xml/atktext.xml">
30   <!ENTITY atk-AtkUtil SYSTEM "xml/atkutil.xml">
31   <!ENTITY atk-AtkValue SYSTEM "xml/atkvalue.xml">
32   <!ENTITY atk-AtkWindow SYSTEM "xml/atkwindow.xml">
33   <!ENTITY atk-AtkVersion SYSTEM "xml/atkversion.xml">
34   <!ENTITY version SYSTEM "version.xml">
35 ]>
36
37 <book>
38   <bookinfo>
39     <title>ATK - Accessibility Toolkit</title>
40     <releaseinfo>for ATK &version;</releaseinfo>
41   </bookinfo>
42
43   <chapter id="overview">
44     <title>Overview</title>
45      <para>
46        GNOME provides support for accessibility devices using the ATK
47        framework. This framework defines a set of interfaces to which
48        graphical interface components adhere. This allows, for instance,
49        screen readers to read the text of an interface and interact with its
50        controls. ATK support is built into GTK+ and the rest of the GNOME
51        platform, so any application using GTK+ will have reasonable
52        accessibility support for free.
53      </para>
54
55      <para>
56      Nonetheless, you should be aware of accessibility issues when when
57      developing your applications. Although GTK+ interfaces provide
58      reasonable accessibility by default, you can often improve how well
59      your program behaves with accessibility tools by providing additional
60      information to ATK. If you develop custom widgets, you should ensure
61      that they expose their properties to ATK
62      </para>
63
64   </chapter>
65
66   <chapter id="atkobject">
67     <title>Base accessibility object</title>
68     &atk-AtkObject;
69   </chapter>
70
71   <chapter id="toolkit">
72     <title>Event and toolkit support</title>
73     &atk-AtkUtil;
74   </chapter>
75
76   <chapter id="interfaces">
77     <title>ATK Interfaces</title>
78     &atk-AtkAction;
79     &atk-AtkComponent;
80     &atk-AtkDocument;
81     &atk-AtkEditabletext;
82     &atk-AtkHyperlinkImpl;
83     &atk-AtkHypertext;
84     &atk-AtkImage;
85     &atk-AtkSelection;
86     &atk-AtkStreamableContent;
87     &atk-AtkTable;
88     &atk-AtkTableCell;
89     &atk-AtkText;
90     &atk-AtkValue;
91     &atk-AtkWindow;
92   </chapter>
93
94   <chapter id="data">
95     <title>Basic accessible data types</title>
96     &atk-AtkRelation;
97     &atk-AtkRelationSet;
98     &atk-AtkState;
99     &atk-AtkStateSet;
100   </chapter>
101
102   <chapter id="accessibles">
103     <title>Custom accessible objects</title>
104     &atk-AtkGObjectAccessible;
105     &atk-AtkHyperlink;
106     &atk-AtkNoOpObject;
107     &atk-AtkPlug;
108     &atk-AtkSocket;
109   </chapter>
110
111   <chapter id="utilities">
112     <title>Utilities</title>
113     &atk-AtkNoOpObjectFactory;
114     &atk-AtkObjectFactory;
115     &atk-AtkRegistry;
116     &atk-AtkVersion;
117   </chapter>
118
119   <chapter id="deprecated">
120     <title>Deprecated Interfaces</title>
121     &atk-AtkMisc;
122   </chapter>
123
124   <index id="api-index-full">
125     <title>Index of all symbols</title>
126   </index>
127   <index id="api-index-deprecated" role="deprecated">
128     <title>Index of deprecated symbols</title>
129   </index>
130   <index id="api-index-1-3" role="1.3">
131     <title>Index of new symbols in 1.3</title>
132   </index>
133   <index id="api-index-1-4" role="1.4">
134     <title>Index of new symbols in 1.4</title>
135   </index>
136   <index id="api-index-1-6" role="1.6">
137     <title>Index of new symbols in 1.6</title>
138   </index>
139   <index id="api-index-1-9" role="1.9">
140     <title>Index of new symbols in 1.9</title>
141   </index>
142   <index id="api-index-1-12" role="1.12">
143     <title>Index of new symbols in 1.12</title>
144   </index>
145   <index id="api-index-1-13" role="1.13">
146     <title>Index of new symbols in 1.13</title>
147   </index>
148   <index id="api-index-1-20" role="1.20">
149     <title>Index of new symbols in 1.20</title>
150   </index>
151   <index id="api-index-1-22" role="1.22">
152     <title>Index of new symbols in 1.22</title>
153   </index>
154   <index id="api-index-1-30" role="1.30">
155     <title>Index of new symbols in 1.30</title>
156   </index>
157   <index id="api-index-2-2" role="2.2">
158     <title>Index of new symbols in 2.2</title>
159   </index>
160   <index id="api-index-2-8" role="2.8">
161     <title>Index of new symbols in 2.8</title>
162   </index>
163   <index id="api-index-2-10" role="2.10">
164     <title>Index of new symbols in 2.10</title>
165   </index>
166
167 </book>
168