README

D-Bus AT-SPI
------------

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.

A page including instructions for testing, project status and
TODO items is kept up to date at:

http://www.linuxfoundation.org/en/AT-SPI_on_D-Bus

The mailing list used for general questions is:

accessibility-atspi@lists.linux-foundation.org

For bug reports, feature requests, patches or enhancements please use
the AT-SPI project on bugzilla.gnome.org. Use the at-spi2-atk component for
bugs specific to this module.

http://bugzilla.gnome.org

A git repository with the latest development code is available at:

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
----------------

The project was started with a D-Bus performance review
the results of which are available on the GNOME wiki. Keep in
mind that the D-Bus AT-SPI design documents on this page
have not been kept up to date.

http://live.gnome.org/GAP/AtSpiDbusInvestigation/

Other sources of relevant information about AT-SPI and Accessibility
include:

http://live.gnome.org/Accessibility
http://www.sun.com/software/star/gnome/accessibility/architecture.xml
http://accessibility.kde.org/developer/atk.php
http://www.gnome.org/~billh/at-spi-idl/html/

Contents of this package
------------------------

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:

droute

Contains a framework for registering objects
with a D-Bus connection and for routing messages to
the implementing object.

Used by the ATK adaptor.

atk-adaptor

This directory contains code that bridges
the at-spi to the GTK+ toolkit, and which is
loaded at runtime by GTK+-based Gnome applications.
The 'bridge' automatically registers GTK+-2.0
applications with the accessibility registry,
and relays UI events from application to registry.
It is also responsible for servicing requests from
the registry to register handlers for specific event
types.