D-Bus accessibility specifications and registration daemon

Emmanuele Bassi ae59b2667b Merge branch 'pkgconfig' into 'master' 2 weeks ago
atspi ae59b2667b Merge branch 'pkgconfig' into 'master' 2 weeks ago
bus 2e449f62a9 bus-launch: use __linux__ over __linux 2 months ago
config 93aea8d1cd 2009-08-21 Mark Doffman <mark.doffman@codethink.co.uk> 9 years ago
dbind 432e2ab84a Avoid compiler warnings 5 months ago
doc 6d48c57ccc Clean up the documentation 1 month ago
idl 737c9853b6 Add ScrollTo and ScrollToPoint component interfaces 5 months ago
m4 9d75b1df59 build: Use modern introspection 1 year ago
po 10d81a5c3d Remove po/Makevars 8 months ago
registryd 1110739743 Use the appropriate annotation 5 months ago
test 840cbcb3b8 Drop autotools support 11 months ago
xml 737c9853b6 Add ScrollTo and ScrollToPoint component interfaces 5 months ago
AUTHORS 531b959416 Correct email address in AUTHORS 8 years ago
COPYING c0a98e7b30 2008-11-13 Mark Doffman <mark.doffman@codethink.co.uk> 10 years ago
INSTALL 3e0e2778b1 2009-07-05 Mark Doffman <mark.doffman@codethink.co.uk> 9 years ago
MAINTAINERS 15140f5a10 Update MAINTAINERS 1 year ago
NEWS 1948f94335 2.29.1 4 months ago
README 148113f2cb More README updates 5 years ago
at-spi2-core.doap 31292e0caa doap: add <programming-language> 4 years ago
git.mk 925201dab4 Use git.mk to maintain .gitignore. 4 years ago
meson.build 8a2107d67c meson: Generate a pkg-config file 1 month ago
meson_options.txt d7f47c99d0 bus-launch: add dbus-broker support 5 months ago

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