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