247N/ACopyright (C) 2004, 2015 Internet Systems Consortium, Inc. ("ISC")
247N/ACopyright (C) 2000, 2001 Internet Software Consortium.
247N/AThe BIND v9 ARM master document is now kept in DocBook 5 XML format.
247N/Aother files included into it:
247N/AAll of the published ARM formats - HTML, PDF, etc - are generated from
714N/AThe file "
notes.xml" contains the release notes for the current release. In
247N/Aaddition to being included in the ARM as an appendix, it is also built into
247N/ABuilding these these files requires DocBook 5 and dblatex. These are
247N/Aavailable as packages in many OS distributes; in debian, for example:
247N/A $ sudo apt-get install docbook5-xml docbook-xml docbook-xsl-ns \
1247N/ATo build all documentation, run "make doc".
247N/AWhen committing changes or submitting patches, it is only necessary to
247N/Aedit the XML source (
i.e., the files with ".docbook" or ".xml" suffixes);
247N/Athe files in HTML and man page format are built from the XML source by a
247N/AIf you are familiar with SGML or HTML, editing the DocBook XML is quite
714N/Astraightforward. You only need to know what the tags are and how to use
714N/Athem. You can find a good resource either for this either online or in
714N/A DocBook: The Definitive Guide
714N/A By Norman Walsh and Leonard Muellner
714N/A 1st Edition, October 1999
714N/A Copyright (C) 1999 by O'Reilly & Associates, Inc. All rights reserved.
714N/AThe book is available online in HTML format:
714N/AAfter editing documentation, it is useful to check the correctness of the
714N/AXML; this can be done using the "xmllint" utility.