aboutsummaryrefslogtreecommitdiff
path: root/doc/README
blob: ab9c0f2f7ceb02f0f0c1e7c3a3aea57a21556989 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Haddock documentation
---------------------

The documentation is in DocBook XML format.  You need some tools to
process it: at least xsltproc, and the DocBook XML DTD and XSL
stylesheets.  There's a configure script to detect the right way to
process the documentation on your system, and a Makefile to actually
do the processing (so, on Windows, you'll need Cygwin or MSys in
addition to the DocBook XML tools).  To build the HTML documentation:

   $ ./configure
   $ make html

which leaves the HTML documentation in a haddock/ subdirectory.

Printable documentation can also be produced, eg.:

   $ make pdf

or

   $ make ps

Generating the printed formats requires more tools (fop or xmltex) and
tends to be a bit harder.