X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=blobdiff_plain;f=tools.dbk;h=a9b4b816da0f35085f559c3529edcfbd3dfcda43;hp=2e5dda24cbac23eb9d489557be085813d201c29c;hb=cff853d72fc9fcfdc7128189431483d9bd03f1c8;hpb=107c9c12638b175f1c124e4546f1ab1143470b50
diff --git a/tools.dbk b/tools.dbk
index 2e5dda2..a9b4b81 100644
--- a/tools.dbk
+++ b/tools.dbk
@@ -499,12 +499,40 @@ enhanced to support cross-compiling.
The following packages provide information for maintainers or help with
building documentation.
+
+
+docbook-xml
+
+docbook-xml provides the
+DocBook XML DTDs, which are commonly used for Debian documentation (as
+is the older debiandoc SGML DTD). This manual, for instance, is
+written in DocBook XML.
+
+
+The docbook-xsl package
+provides the XSL files for building and styling the source to various
+output formats. You will need an XSLT processor, such as xsltproc, to use the XSL stylesheets.
+Documentation for the stylesheets can be found in the various
+docbook-xsl-doc-* packages.
+
+
+To produce PDF from FO, you need an FO processor, such as xmlroff or fop. Another tool to generate PDF from
+DocBook XML is dblatex.
+
+
+
debiandoc-sgml
debiandoc-sgml provides the DebianDoc
-SGML DTD, which is commonly used for Debian documentation. This manual, for
-instance, is written in DebianDoc. It also provides scripts for building and
+SGML DTD, which is commonly used for Debian documentation,
+but is now deprecated
+(docbook-xml
+should be used instead).
+It also provides scripts for building and
styling the source to various output formats.
@@ -512,22 +540,6 @@ Documentation for the DTD can be found in the debiandoc-sgml-doc package.
-