Introduction to GAIL

The GAIL package provides accessibility support for GTK+ and libgnomecanvas by implementing AtkObjects for widgets in GTK+ and libgnomecanvas. The GAIL library is a GTK+ module. This module is normally used with the atk-bridge GTK+ module from AT-SPI to allow an assistive technology, e.g., a screenreader, to query or drive the program.

Package Information

GAIL Dependencies





User Notes:

Installation of GAIL



The instructions below are based on installing the package into a GNOME-2 environment. If, for whatever reason, you're installing this package without having ORBit2 and the core GNOME-2 libraries installed, you'll need to modify the --prefix= parameter on the configure script to point to your desired installation path (e.g., --prefix=/usr).

Install GAIL by running the following commands:

./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) &&

This package does not come with a test suite.

Now, as the root user:

make install &&

if [ $(pkg-config --variable=prefix ORBit-2.0) != "/usr" ]; then
    ln -v -s $(pkg-config --variable=prefix \
             ORBit-2.0)/lib/gtk-2.0/modules \

Command Explanations

--prefix=$(pkg-config --variable=prefix ORBit-2.0): Setting the prefix using this parameter instead of with $GNOME_PREFIX will ensure that the prefix is consistent with the installation environment and the package will be installed in the correct location.

--enable-gtk-doc: Use this parameter if GTK-Doc is installed and you wish to rebuild the API documentation.

if [ ... != "/usr" ]; then ...; fi: GTK+ will look for the GAIL modules in /usr/lib even if $GNOME_PREFIX is NOT /usr. This command creates a symbolic link to satisfy this requirement.


Installed Programs: None
Installed Libraries: and GAIL GTK+ modules
Installed Directories: The following subdirectories of $GNOME_PREFIX/: include/gail-1.0, lib/gtk-2.0/modules and share/gtk-doc/html/gail-libgail-util

Short Descriptions

provides the functions that solve accessibility problems in a consistent manner across GNOME.

Last updated on 2007-08-08 09:57:59 -0500