Beyond Linux® From Scratch - Version 6.3

Chapter 29. GNOME Core Packages

GAIL-1.18.0

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

Required

libgnomecanvas-2.14.0

Optional

GTK-Doc-1.8

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/gail

Installation of GAIL

[Note]

Note

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) &&
make

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 \
         /usr/lib/gtk-2.0
fi

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.

Contents

Installed Programs: None
Installed Libraries: libgailutil.so 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

libgailutil.so

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

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