README.md: Add info about building the documentation

kjellahl · kjellahl · commit 6d38d0178d07 · 2023-12-26T10:28:39.000+01:00
Fixes #101
diff --git a/README.md b/README.md
@@ -59,6 +59,21 @@ supplier of your operating system, such as your Linux distribution. For
 instance, Ubuntu Linux, Debian Linux and Fedora Linux have official libsigc++
 packages.
 
+## Building the documentation
+
+The reference documentaion is built with Doxygen.
+
+The manual is a DocBook 5.0 document. These packages are recommended when building
+the manual (can have other names in other distros):
+ - docbook5-xml (Ubuntu and Debian) or docbook5-schemas (Fedora)
+ - docbook-xsl (Ubuntu and Debian) or docbook-style-xsl (Fedora)
+
+It may be possible to build without these packages, but it will be slow and error prone.
+The `xmllint` command is told to read files from http://docbook.org.
+The `xsltproc` command is told to read files from http://docbook.sourceforge.net.
+The commands first search for local copies of those files. If local copies exist
+and are installed at expected locations, the commands make no network accesses.
+
 ## Building from a release tarball
 
 Building from a release tarball is easier than building from git.
