Beyond Linux® From Scratch - Version 2012-02-12

Chapter 33. GNOME Core Packages

GNOME Doc Utils-0.20.6

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.

This package is known to build using an LFS 7.0 platform but has not been tested.

Package Information

GNOME Doc Utils Dependencies

Required

intltool-0.50.0, libxslt-1.1.26, and Python-2.7.2 ( Required to be installed prior to libxml2-2.7.8)

Recommended

Rarian-0.8.1

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: http://wiki.linuxfromscratch.org/blfs/wiki/gnome-doc-utils

Installation of GNOME Doc Utils

[Note]

Note

The instructions below are based on installing the package into a GNOME environment. If, for whatever reason, you're installing this package without having the core GNOME 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: 

./configure --prefix=$GNOME_PREFIX &&
make

To test the results, issue: make check.

Now, as the root user: 

make install

Command Explanations

--prefix=$GNOME_PREFIX: Setting the prefix using this parameter will ensure that the prefix is consistent with the installation environment and the package will be installed in the correct location.

Contents

Installed Programs: gnome-doc-prepare, gnome-doc-tool and xml2po
Installed Libraries: None
Installed Directories: $GNOME_PREFIX/share/{gnome-doc-utils/{icons/hicolor/{48x48/status, scalable/status},templates,watermarks},gnome/help/{gnome-doc-make/{C, de},gnome-doc-xslt/{C,de}},omf/{gnome-doc-make,gnome-doc-xslt}, xml/{gnome/xslt/{common,docbook/{common,html,omf,utils},gettext, mallard/{cache,common,html}},mallard/1.0}} and /usr/lib/python2.7/site-packages/xml2po/
Installed Stylesheets: Custom DocBook XSLT stylesheets

Short Descriptions

gnome-doc-prepare

prepares a package to use gnome-doc-utils.

gnome-doc-tool

is used to convert documents to either HTML or XHTML.

xml2po

is a Python script used to translate XML documents.

Last updated on 2012-02-12 01:17:45 +0000