Getting GTK-Doc

1.3.1. Requirements

Perl v5 — the main scripts are in Perl.

DocBook DTD v3.0 — This is the DocBook SGML DTD. http://www.ora.com/davenport

Jade v1.1 — This is a DSSSL processor for converting SGML to various formats. http://www.jclark.com/jade

Modular DocBook Stylesheets This is the DSSSL code to convert DocBook to HTML (and a few other formats). It's used together with jade. The DSSSL code has been customised slightly, in gtk-doc.dsl, to colour the program code listings/declarations, and to support global cross-reference indices in the generated HTML. http://nwalsh.com/docbook/dsssl

docbook-to-man — if you want to create man pages from the DocBook. The 'translation spec' has been customised slightly, to capitalise section headings and add the 'GTK Library' title at the top of the pages and the revision date at the bottom. There is a link to this on http://www.ora.com/davenport NOTE: This does not work yet.

1.3.2. Installation

There is no standard place where the DocBook Modular Stylesheets are installed.

GTK-Doc's configure script searches these 3 directories automatically:

/usr/lib/sgml/stylesheets/nwalsh-modular (used by Red Hat)

/usr/lib/dsssl/stylesheets/docbook (used by Debian)

/usr/share/sgml/docbkdsl (used by SuSE)

If you have the stylesheets installed somewhere else, you need to configure GTK-Doc using the option: --with-dsssl-dir=<PATH_TO_TOPLEVEL_STYLESHEETS_DIR>