D-Bus accessibility specifications and registration daemon

Mike Gorse 1948f94335 2.29.1 1 month ago
atspi 62d6219297 build: Silence g-ir-scanner 3 months ago
bus a73b0506e6 Do not use deprecated GSettings API 3 months ago
config 93aea8d1cd 2009-08-21 Mark Doffman <mark.doffman@codethink.co.uk> 9 years ago
dbind 432e2ab84a Avoid compiler warnings 3 months ago
doc 737c9853b6 Add ScrollTo and ScrollToPoint component interfaces 3 months ago
idl 737c9853b6 Add ScrollTo and ScrollToPoint component interfaces 3 months ago
m4 9d75b1df59 build: Use modern introspection 1 year ago
po 10d81a5c3d Remove po/Makevars 5 months ago
registryd 1110739743 Use the appropriate annotation 3 months ago
test 840cbcb3b8 Drop autotools support 9 months ago
xml 737c9853b6 Add ScrollTo and ScrollToPoint component interfaces 3 months ago
AUTHORS 531b959416 Correct email address in AUTHORS 8 years ago
COPYING c0a98e7b30 2008-11-13 Mark Doffman <mark.doffman@codethink.co.uk> 9 years ago
INSTALL 3e0e2778b1 2009-07-05 Mark Doffman <mark.doffman@codethink.co.uk> 9 years ago
MAINTAINERS 15140f5a10 Update MAINTAINERS 11 months ago
NEWS 1948f94335 2.29.1 1 month ago
README 148113f2cb More README updates 5 years ago
at-spi2-core.doap 31292e0caa doap: add <programming-language> 4 years ago
atspi-2.pc.in 27438fe5d8 Add glib-2.0 to requires in at-spi2.pc.in 6 years ago
git.mk 925201dab4 Use git.mk to maintain .gitignore. 4 years ago
meson.build 0782b360a6 Bump version 3 months ago
meson_options.txt d7f47c99d0 bus-launch: add dbus-broker support 3 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.