-This is the initial CVS checkin of the Gnome Accessibility Project's
-Assistive Technology Service Provider Interface.
+D-Bus AT-SPI
+------------
-At the moment it does not include IDL for all of the SPI, but it does
-provide a prototype implementation of the core of the out-of-process
-accessibility service, the 'registry'.
+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.
-Accessible applications will register with this registry service (via OAF)
-and adaptive/assistive technologies will register with the service as
-well, to indicate their interest in receiving UI events. ATs can also use
-the registry's services programmatically to query accessible applications.
+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
-Running the test programs: ============================
+The mailing list used for general questions is:
-At the moment the only clients and 'apps' are the test at client and
-test app in the 'tests' subdirectory.
+ accessibility-atspi@lists.linux-foundation.org
-If you have a working ORBit2/OAF installation you can run the tests after
-adding the registryd directory to OAF's directory list with oaf-sysconf,
-or by installing Accessibility_Registry.oaf in your 'oafinfo' directory.
+For bug reports, feature requests, patches or enhancements please use
+the AT-SPI project on bugzilla.gnome.org. Use the at-spi2-core component for
+bugs specific to this module.
-You can then run './at' and './app' from the 'test' directory, to see
-'app' register as an application, and 'at' as a listening client.
-OAF should take care of the job of bootstrapping the registry daemon
-('registryd') for you.
+ http://bugzilla.gnome.org
-At the moment app and at deregistration are broken, so you are advised
-to kill the registry daemon if you exit either 'at' or 'app' instances.
-You may run as many instances of each as you like, concurrently - you
-may find it useful to do so in separate terminal windows.
+A git repository with the latest development code is available at:
+ git://git.gnome.org/at-spi2-core
-'at' connects to the registry as an event listener, then queries the
-service for the number of virtual desktops (currently always 0 or 1),
-and queries each desktop for the accessible applications it is running.
-It then prints out the name of each such application (as reported by the
-application's accessibility interfaces), and then waits to receive events.
+More information
+----------------
-'app' connects to the registry as an application, then dispatches an
-event which the registry should relay to all registered listeners.
-Thus instances of 'app' run after 'at' should cause the 'at' instances
-to receive events.
+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/
--Bill
+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 the protocol definitions for the new D-Bus
+at-spi.
+
+Also included is the daemon necessary for forwarding device events
+and registering accessible applicaitions.
+
+
+Directory structure
+-------------------
+
+The directories within this package are arranged as follows:
+
+ xml
+
+ This directory contains XML documents describing
+ the D-Bus protocol in the format used for D-Bus introspection.
+
+ idl
+
+ The D-Bus specification in an idl-like format. This is likely not
+ parseable by any existing tools, is not entirely up-to-date, and may
+ by removed in a future release.
+
+ 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.
+
+ 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 libatspi.
+
+ atspi
+
+ C library for use by ATs. Wraps the various D-Bus calls, provides
+ an interface for listening to events, and caches some information about
+ accessible objects. Also contains some functions used by at-spi2-atk.
+
+ bus
+
+ A server that sits on the session bus and provides an interface
+ allowing applications to find the accessibility bus daemon, launching
+ it as needed. The accessibility bus is separate from the session bus
+ because it may in fact span user sessions if a user, for instance,
+ runs an application that escalates to run as root. The accessibility
+ bus is thus tied to the X session rather than the D-Bus session.
+
+ doc
+
+ Contains infrastructure for creating libatspi documentation.
+
+ test
+
+ Contains files that may be useful for testing AT-SPI.
+
+ m4
+
+ Some macros used for building the module.
+
+ po
+
+ Infrastructure used for translation.