D-Bus AT-SPI
------------
-This version of at-spi is a major break from previous versions.
+This version of at-spi is a major break from version 1.x.
It has been completely rewritten to use D-Bus rather than
ORBIT / CORBA for its transport protocol.
accessibility-atspi@lists.linux-foundation.org
For bug reports, feature requests, patches or enhancements please use
-bugzilla. The freedesktop project name is at-spi2.
+the AT-SPI project on bugzilla.gnome.org. Use the at-spi2-atk component for
+bugs specific to this module.
- http://bugs.freedesktop.org
+ http://bugzilla.gnome.org
A git repository with the latest development code is available at:
- git://anongit.freedesktop.org/git/at-spi2
+ git://git.gnome.org/at-spi2-atk
+Code in this repository depends on at-spi2-core resources. The
+at-spi2-core repository can be found at:
+
+ git://git.gnome.org/at-spi2-core
More information
----------------
Contents of this package
------------------------
-This package includes the protocol definitions for the new D-Bus
-at-spi, a gtk-module that bridges ATK to the new D-Bus based AT-SPI
-as well as 'C' and Python client libraries.
-
-Also included is the daemon neccessary for forwarding device events
-and registering accessible applicaitons.
-
+This package includes libatk-bridge, a library that bridges ATK to the new
+D-Bus based AT-SPI, as well as a corresponding module for gtk+ 2.x. Gtk+ 3.x
+now links against libatk-bridge directly rather than requiring it to be loaded
+as a module.
+These libraries depend on the at-spi2-core code that contains the daemon for
+registering applications, D-Bus helper libraries and the AT-SPI D-Bus specifications.
Directory structure
-------------------
The directories within this package are arranged as follows:
- idl
-
- This directory contains the interface definitions
- (in Interface Definition Language) for the
- accessibility support interfaces exposed by
- the AT central registry, accessible applications,
- and UI components.
-
- This is possibly historic. The idl formed the basis
- for the XML protocol definitions now located
- in the directory "xml".
-
- xml
-
- This directory contains XML documents describing
- the D-Bus protocol in a subset of Telepathy XML.
-
- tools
-
- Miscellaneous tools. Mostly for converting protocol
- XML into D-Bus introspection, 'C' types and documentation.
-
droute
Contains a framework for registering objects
Used by the ATK adaptor.
- dbind
-
- Library to ease making D-Bus method calls, contains
- marshalling code to convert function arguments
- and a provided D-Bus signature into a D-Bus message.
-
- Used by cspi.
-
- spi-common
-
- Contains 'C' types derived from the D-Bus
- protocol specification. These types are used by
- both the registry daemon and the ATK adaptor.
- Structures are mainly related to events.
-
- registryd
-
- This directory contains code specific to the
- central accessibility registry, and the registry
- executable is built in this directory.
-
atk-adaptor
This directory contains code that bridges
It is also responsible for servicing requests from
the registry to register handlers for specific event
types.
-
- cspi
-
- The client (AT) side interface - 'C' bindings.
-
- registryd
-
- The registry daemon code. The registry daemon
- keeps a register of accessible applications and presents
- this to clients (ATs).
- It is also responsible for delivering device events.