[svn] commit: r1529 - in /trunk/doc/userguide: userguide.css userguide.xml
BIND 10 source code commits
bind10-changes at lists.isc.org
Thu Mar 18 19:29:27 UTC 2010
Author: mgraff
Date: Thu Mar 18 19:29:27 2010
New Revision: 1529
Log:
reorder some more; move supported os and requirements into the intro section, not the installation section.
Modified:
trunk/doc/userguide/userguide.css
trunk/doc/userguide/userguide.xml
Modified: trunk/doc/userguide/userguide.css
==============================================================================
--- trunk/doc/userguide/userguide.css (original)
+++ trunk/doc/userguide/userguide.css Thu Mar 18 19:29:27 2010
@@ -28,7 +28,3 @@
-moz-border-radius: 10px;
-webkit-border-radius: 10px;
}
-
-.section {
- padding-left: 1em;
-}
Modified: trunk/doc/userguide/userguide.xml
==============================================================================
--- trunk/doc/userguide/userguide.xml (original)
+++ trunk/doc/userguide/userguide.xml Thu Mar 18 19:29:27 2010
@@ -41,24 +41,94 @@
authoritative DNS server.
</para>
</note>
-
- <para>
- BIND 10 is modular. Part of this modularity is
- accomplished using multiple cooperating processes which, together,
- provide DNS functionality. This is a change from the previous generation
- of BIND software, which used a single process.
- </para>
-
- <para>
- At first, running many different processes may seem confusing. However,
- these processes are started, stopped, and maintained by a single command,
- <command>bind10</command>. Additionally, most processes started by
- the <command>bind10</command> command have names starting with "b10-",
- with one exception, <command>msgq</command>.
- </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 CentOS
+ Linux 5.3.
+
+ It has been tested on Sparc, i386, and amd64 hardware
+ platforms.
+
+ It is planned for BIND 10 to build, install and run on
+ Windows and standard Unix-type platforms.
+ </para>
+ </section>
+
+ <section>
+ <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.
+ </para>
+
+ <para>
+ Building from source code requires the Boost
+ build-time headers. At least Boost version 1.34 is required.
+<!-- TODO: we don't check for this version -->
+<!-- NOTE: jreed has tested with 1.34, 1.38, and 1.41. -->
+ </para>
+
+ <para>
+ If the Boost System Library is detected at configure time,
+ BIND 10 will be built using an alternative method for
+ networking I/O using Boost ASIO support. This provides
+ asynchrony support; with ASIO the Authoritative DNS server
+ can handle other queries while the processing of a TCP
+ transaction stalls.
+ This dependency is not required unless you need
+ <!-- TODO: want --> this feature as TCP transport support is
+ provided using alternative code.
+ </para>
+
+ <note><para>
+ For the Y1 prototype release, the only supported data source
+ backend is SQLite3. The authoritative server requires
+ SQLite 3.3.9 or newer,
+ and the <command>b10-xfrin</command> module requires the
+ Python _sqlite3.so module.
+ </para></note>
+<!-- TODO: this will change ... -->
+
+<!-- TODO: list where to get these from -->
+
+ <note>
+ <para>
+ Some operating systems do not provide these dependencies
+ in their default installation nor standard packages
+ collections.
+ You may need to install them separately.
+ </para>
+ </note>
+
+ <para>
+ Building BIND 10 also requires a C++ compiler and
+ standard development headers.
+ BIND 10 builds have been tested with GCC g++ 3.4.3, 4.1.2,
+ 4.2.1, 4.3.2, and 4.4.1.
+ </para>
+
+ </section>
<section id="starting_stopping">
<title>Starting and Stopping the Server</title>
+
+ <para>
+ BIND 10 is modular. Part of this modularity is
+ accomplished using multiple cooperating processes which, together,
+ provide DNS functionality. This is a change from the previous generation
+ of BIND software, which used a single process.
+ </para>
+
+ <para>
+ At first, running many different processes may seem confusing. However,
+ these processes are started, stopped, and maintained by a single command,
+ <command>bind10</command>. Additionally, most processes started by
+ the <command>bind10</command> command have names starting with "b10-",
+ with one exception, <command>msgq</command>.
+ </para>
<para>
Starting and stopping the server is performed by a single command,
@@ -172,72 +242,6 @@
<chapter id="installation">
<title>Installation</title>
- <section>
- <title>Required Software</title>
- <para>
- BIND 10 requires Python 3.1.
- </para>
-
- <para>
- Building from source code requires the Boost
- build-time headers. At least Boost version 1.34 is required.
-<!-- TODO: we don't check for this version -->
-<!-- NOTE: jreed has tested with 1.34, 1.38, and 1.41. -->
- </para>
-
- <para>
- If the Boost System Library is detected at configure time,
- BIND 10 will be built using an alternative method for
- networking I/O using Boost ASIO support. This provides
- asynchrony support; with ASIO the Authoritative DNS server
- can handle other queries while the processing of a TCP
- transaction stalls.
- This dependency is not required unless you need
- <!-- TODO: want --> this feature as TCP transport support is
- provided using alternative code.
- </para>
-
- <note><para>
- For the Y1 prototype release, the only supported data source
- backend is SQLite3. The authoritative server requires
- SQLite 3.3.9 or newer,
- and the XFRin module requires the Python _sqlite3.so module.
- </para></note>
-<!-- TODO: this will change ... -->
-
-<!-- TODO: list where to get these from -->
-
- <note><para>
- Some operating systems do not provide these dependencies
- in their default installation nor standard packages
- collections.
- You may need to install them separately.
- </para></note>
-
- <para>
- Building BIND 10 also requires a C++ compiler and
- standard development headers.
- BIND 10 builds have been tested with GCC g++ 3.4.3, 4.1.2,
- 4.2.1, 4.3.2, and 4.4.1.
- </para>
-
- </section>
-
- <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 CentOS
- Linux 5.3.
-
- It has been tested on Sparc, i386, and amd64 hardware
- platforms.
-
- It is planned for BIND 10 to build, install and run on
- Windows and standard Unix-type platforms.
- </para>
- </section>
-
<section id="quickstart">
<title>Quick start</title>
<para>
More information about the bind10-changes
mailing list