X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=README;h=e41a5c66adf1803c051b55c0ce597aafc74befc4;hb=a49f39ec9c4497fda18081bfc5ddc5aec063f83d;hp=64ac1318393f8ec60c33e0775247568442550bb0;hpb=c0a98e7b304b6e7496b87208f5e9951f181da44f;p=platform%2Fupstream%2Fat-spi2-core.git diff --git a/README b/README index 64ac131..e41a5c6 100644 --- a/README +++ b/README @@ -1,7 +1,7 @@ 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. @@ -15,14 +15,14 @@ The mailing list used for general questions is: 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-core 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-core More information ---------------- @@ -43,17 +43,14 @@ include: 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, 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. +at-spi. +Also included is the daemon necessary for forwarding device events +and registering accessible applicaitions. Directory structure @@ -61,35 +58,23 @@ 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 + the D-Bus protocol in the format used for D-Bus introspection. - Miscellaneous tools. Mostly for converting protocol - XML into D-Bus introspection, 'C' types and documentation. + idl - droute + 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. - Contains a framework for registering objects - with a D-Bus connection and for routing messages to - the implementing object. + registryd - Used by the ATK adaptor. + 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 @@ -97,40 +82,35 @@ The directories within this package are arranged as follows: marshalling code to convert function arguments and a provided D-Bus signature into a D-Bus message. - Used by cspi. + Used by libatspi. - spi-common + atspi - 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. + 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. - registryd + bus - This directory contains code specific to the - central accessibility registry, and the registry - executable is built in this directory. + 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. - atk-adaptor + doc - 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. + Contains infrastructure for creating libatspi documentation. - cspi + test - The client (AT) side interface - 'C' bindings. + Contains files that may be useful for testing AT-SPI. - registryd + m4 - 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. + Some macros used for building the module. + + po + + Infrastructure used for translation.