Documentation Tools

Installing Doctools

This page details the process of installing and configuring Doctools for building your documents.

This collection is intended to be imported into the documentation tree of a project, most likely via the Subversion svn:externals property. An example of the svn:externals used would be:

doctools        http://svn.water-powered.com/doctools/trunk

This would typically be done in Subversion on the documentation folder of a project.

For each subdirectory in a project's documentation folder that contains Docbook documents, all that is needed is a Makefile that includes Doctools. For example, the  PureDocs Plugins document uses the  following Makefile:

NAME =      plugins
SOURCE =    plugins.xml
PROJECT_NAME = PureDocs
PROJECT_URL = http://ideas.water-powered.com/projects/puredocs

include ../doctools/Mk/docbook.mk