GNOME Doc Utils-0.6.1

Introduction to GNOME Doc Utils

The GNOME Doc Utils package is a collection of documentation utilities for the GNOME project. Notably, it contains utilities for building documentation and all auxiliary files in your source tree, and it contains the DocBook XSLT stylesheets that were once distributed with Yelp. Starting with GNOME 2.8, Yelp requires GNOME Doc Utils for the XSLT. Starting with GNOME 2.12, many of the core GNOME packages require GNOME Doc Utils.

Package Information

GNOME Doc Utils Dependencies




Python-2.4.4 and ScrollKeeper-0.3.14

The packages are listed as recommended even though GNOME Doc Utils will build fine without them. If you don't install the recommended packages (and you pass the appropriate flags to the configure command so that it will build without them), functionality will be missing that is expected later in other GNOME packages.



User Notes:

Installation of GNOME Doc Utils



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 GNOME Doc Utils by running the following commands:

sed -i 's/@.*@pkgconfig/pkgconfig/' &&
./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
            --mandir=$(pkg-config \
                --variable=prefix ORBit-2.0)/share/man &&

To test the results, issue: make check.

Now, as the root user:

make install

Command Explanations

sed -i 's/@.*@pkgconfig/pkgconfig/' If you build GNOME Doc Utils without Python, the pkg-config support files will not be installed. This command ensures that they are always installed.

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

--mandir=$(pkg-config --variable=prefix ORBit-2.0)/share/man: This parameter causes the man.(X) files to be installed in $GNOME_PREFIX/share/man/man(X) instead of $GNOME_PREFIX/man/man(X).


Installed Programs: gnome-doc-prepare and xml2po
Installed Libraries: None
Installed Directories: The following subdirectories of $GNOME_PREFIX/share/: gnome-doc-utils, gnome/help/gnome-doc-{make,xslt}, omf/gnome-doc-{make,xslt}, xml/gnome and xml2po}
Installed Stylesheets: Custom DocBook XSLT stylesheets

Short Descriptions


prepares a package to use gnome-doc-utils.


is a Python script used to translate XML documents.

Last updated on 2007-01-18 13:38:19 -0600