aboutsummaryrefslogtreecommitdiff
path: root/doc/README.md
diff options
context:
space:
mode:
authorBen Gamari <ben@smart-cactus.org>2016-02-07 11:21:42 -0500
committerBen Gamari <ben@smart-cactus.org>2016-02-08 12:46:49 +0100
commitbfd47453c76c7fb849c50eed750f61e28dc5cbdb (patch)
tree780962886103957b9e3b13a19b651d4e9a1baf24 /doc/README.md
parent8a4c949bfc731ef0dcd83d557da278d162152fb5 (diff)
doc: Switch to Sphinx
Diffstat (limited to 'doc/README.md')
-rw-r--r--doc/README.md23
1 files changed, 4 insertions, 19 deletions
diff --git a/doc/README.md b/doc/README.md
index cf1fc31b..947d7f93 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -1,25 +1,10 @@
# 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:
+The documentation is in ReStructuredText format. You need
+[Sphinx](http://www.sphinx-doc.org/) to process it. To build the HTML
+documentation,
- $ autoconf
- $ ./configure
$ make html
-which leaves the HTML documentation in a haddock/ subdirectory.
+which leaves the HTML documentation the `.build-html/` 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.