X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=tools.dbk;h=a9b4b816da0f35085f559c3529edcfbd3dfcda43;hb=5b3e31d3f3c1aaeb2ce5e03cda021d1cbbc7b93a;hp=7f6264824884f7aff730e212966bc8c34e9b35bd;hpb=77cab965d9dbb3b3ec96b588c612b3dba78efb3a;p=developers-reference.git
diff --git a/tools.dbk b/tools.dbk
index 7f62648..a9b4b81 100644
--- a/tools.dbk
+++ b/tools.dbk
@@ -95,10 +95,10 @@ errors.
You should periodically get the newest lintian from `unstable' and check over all your
-packages. Notice that the -i option provides detailed
-explanations of what each error or warning means, what its basis in Policy is,
-and commonly how you can fix the problem.
+role="package">lintian from unstable and check
+over all your packages. Notice that the -i option provides
+detailed explanations of what each error or warning means, what its basis in
+Policy is, and commonly how you can fix the problem.
Refer to for more information on how and when to
@@ -108,16 +108,7 @@ use Lintian.
You can also see a summary of all problems reported by Lintian on your packages
at . These reports contain the
latest lintian output for the whole development distribution
-(unstable).
-
-
-
-
-linda
-
-linda is another package linter. It is
-similar to lintian but has a different
-set of checks. Its written in Python rather than Perl.
+(unstable).
@@ -271,8 +262,8 @@ upstream changes into the repository.
These utilities provide an infrastructure to facilitate the use of CVS by
Debian maintainers. This allows one to keep separate CVS branches of a package
-for stable, unstable and possibly
-experimental distributions, along with the other benefits
+for stable, unstable and possibly
+experimental distributions, along with the other benefits
of a version control system.
@@ -315,8 +306,8 @@ environment.
It can use chrooted environments as well. It can be used stand-alone, or as
part of a networked, distributed build environment. As the latter, it is part
of the system used by porters to build binary packages for all the available
-architectures. See for more information, and to see the system in action.
+architectures. See for more information, and
+ to see the system in action.
@@ -508,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.
@@ -521,22 +540,6 @@ Documentation for the DTD can be found in the debiandoc-sgml-doc package.
-
debian-keyring
@@ -546,6 +549,14 @@ linkend="key-maint"/> and the package documentation for more information.
+
+debian-maintainers
+
+Contains the public GPG keys of Debian Maintainers.
+See for more information.
+
+
+