BIND 10 master, updated. 55982f5001add9a6da88b65ff543034a19b37b2b [master] move acknowledgments section
BIND 10 source code commits
bind10-changes at lists.isc.org
Thu Jan 5 14:17:52 UTC 2012
The branch, master has been updated
via 55982f5001add9a6da88b65ff543034a19b37b2b (commit)
via 45e6dee0837447b6ea501394a6a3b9274f77f315 (commit)
from 65e86785b51677742f456ebad3d935a0cbbbeb93 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 55982f5001add9a6da88b65ff543034a19b37b2b
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Jan 4 13:29:09 2012 -0600
[master] move acknowledgments section
slight rewording
made a preface
commit 45e6dee0837447b6ea501394a6a3b9274f77f315
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Jan 4 11:17:16 2012 -0600
[master] various minor doc changes
moved some content
changed some formatting tags
mention more platforms
add some anchor link IDs
add some URls for dependencies
slight rewording
point to wiki for more tips
-----------------------------------------------------------------------
Summary of changes:
doc/guide/bind10-guide.xml | 110 +++++++++++++++++++++++--------------------
1 files changed, 59 insertions(+), 51 deletions(-)
-----------------------------------------------------------------------
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index c58a97f..5cf7271 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -53,6 +53,20 @@
</bookinfo>
+ <preface>
+ <title>Preface</title>
+
+ <section id="acknowledgements">
+ <title>Acknowledgements</title>
+
+ <para>ISC would like to acknowledge generous support for
+ BIND 10 development of DHCPv4 and DHCPv6 components provided
+ by <ulink url="http://www.comcast.com/">Comcast</ulink>.</para>
+
+ </section>
+
+ </preface>
+
<chapter id="intro">
<title>Introduction</title>
<para>
@@ -60,29 +74,22 @@
interfaces, and DNS tools.
BIND 10 is a rewrite of BIND 9. BIND 10 is written in C++ and Python
and provides a modular environment for serving and maintaining DNS.
+ BIND 10 provides a EDNS0- and DNSSEC-capable authoritative
+ DNS server and a caching recursive name server which also
+ provides forwarding.
</para>
- <note>
- <para>
- This guide covers the experimental prototype of
- BIND 10 version &__VERSION__;.
- </para>
- </note>
-
- <note>
- <para>
- BIND 10 provides a EDNS0- and DNSSEC-capable
- authoritative DNS server and a caching recursive name server
- which also provides forwarding.
- </para>
- </note>
+ <para>
+ This guide covers the experimental prototype of
+ BIND 10 version &__VERSION__;.
+ </para>
<section>
<title>Supported Platforms</title>
<para>
- BIND 10 builds have been tested on Debian GNU/Linux 5,
- Ubuntu 9.10, NetBSD 5, Solaris 10, FreeBSD 7 and 8, and CentOS
- Linux 5.3.
+ BIND 10 builds have been tested on Debian GNU/Linux 5 and unstable,
+ Ubuntu 9.10, NetBSD 5, Solaris 10, FreeBSD 7 and 8, CentOS
+ Linux 5.3, and MacOS 10.6.
It has been tested on Sparc, i386, and amd64 hardware
platforms.
@@ -92,33 +99,42 @@
</para>
</section>
- <section>
+ <section id="required-software">
<title>Required Software</title>
<para>
- BIND 10 requires Python 3.1. Later versions may work, but Python
- 3.1 is the minimum version which will work.
+ BIND 10 requires at least Python 3.1
+ (<ulink url="http://www.python.org/"/>).
+ It has also been tested with Python 3.2.
+ </para>
+
+ <para>
+ BIND 10 uses the Botan crypto library for C++
+ (<ulink url="http://botan.randombit.net/"/>).
+ It requires at least Botan version 1.8.
</para>
<para>
- BIND 10 uses the Botan crypto library for C++. It requires
- at least Botan version 1.8.
+ BIND 10 uses the log4cplus C++ logging library
+ (<ulink url="http://log4cplus.sourceforge.net/"/>).
+ It requires at least log4cplus version 1.0.3.
</para>
<para>
- BIND 10 uses the log4cplus C++ logging library. It requires
- at least log4cplus version 1.0.3.
+ The authoritative DNS server uses SQLite3
+ (<ulink url="http://www.sqlite.org/"/>).
+<!-- TODO: is this still required? -->
+ It needs at least SQLite version 3.3.9.
</para>
<para>
- The authoritative server requires SQLite 3.3.9 or newer.
The <command>b10-xfrin</command>, <command>b10-xfrout</command>,
- and <command>b10-zonemgr</command> modules require the
- libpython3 library and the Python _sqlite3.so module.
+ and <command>b10-zonemgr</command> components require the
+ libpython3 library and the Python _sqlite3.so module
+ (which is included with Python).
+ The Python module needs to be built for the corresponding Python 3.
</para>
<!-- TODO: this will change ... -->
-<!-- TODO: list where to get these from -->
-
<note>
<para>
Some operating systems do not provide these dependencies
@@ -319,7 +335,7 @@ var/
<chapter id="installation">
<title>Installation</title>
- <section>
+ <section id="build-requirements">
<title>Building Requirements</title>
<para>
@@ -338,7 +354,9 @@ var/
<para>
Building from source code requires the Boost
- build-time headers. At least Boost version 1.35 is required.
+ build-time headers
+ (<ulink url="http://www.boost.org/"/>).
+ At least Boost version 1.35 is required.
<!-- TODO: we don't check for this version -->
<!-- NOTE: jreed has tested with 1.34, 1.38, and 1.41. -->
</para>
@@ -355,16 +373,8 @@ Debian and Ubuntu:
libgmp3-dev and libbz2-dev required for botan too
-->
- <para>
-<!-- TODO: is this needed at build time? test time? -->
- The Python Library and Python _sqlite3 module are required to
- enable the Xfrout and Xfrin support.
- </para>
-
- <note><simpara>
- The Python related libraries and modules need to be built
- for Python 3.1.
- </simpara></note>
+<!-- NOTE: _sqlite3 is only needed at test time; it is already listed
+as a dependency earlier -->
<para>
Building BIND 10 also requires a C++ compiler and
@@ -372,6 +382,13 @@ Debian and Ubuntu:
BIND 10 builds have been tested with GCC g++ 3.4.3, 4.1.2,
4.1.3, 4.2.1, 4.3.2, and 4.4.1; Clang++ 2.8; and Sun C++ 5.10.
</para>
+
+ <para>
+ Visit the wiki at <ulink
+ url="http://bind10.isc.org/wiki/SystemSpecificNotes" />
+ for system-specific installation tips.
+ </para>
+
</section>
<section id="quickstart">
@@ -393,7 +410,7 @@ Debian and Ubuntu:
<listitem>
<simpara>
- Install required build dependencies.
+ Install required run-time and build dependencies.
</simpara>
</listitem>
@@ -3012,15 +3029,6 @@ Logging/loggers[0]/output_options[0]/maxver 8 integer (modified)
</chapter>
-<!-- TODO: acknolwedgements must be unnumbered -->
-
- <chapter>
- <title>Acknowledgements</title>
- <para>ISC would like to acknowledge generous support for
- development of DHCPv4 and DHCPv6 components provided by <ulink
- url="http://www.comcast.com">Comcast</ulink>.</para>
- </chapter>
-
<!-- TODO: Add bibliography section (mostly RFCs, probably) -->
More information about the bind10-changes
mailing list