BIND 10 jreed-docs, updated. f664bc1482edb6da965169317f04f2d7b6458fbd [jreed-docs] miscellaneous docs

[BIND 10 source code commits]

The branch, jreed-docs has been updated
       via  f664bc1482edb6da965169317f04f2d7b6458fbd (commit)
       via  e241028cc0993fb87306bd097a45f99a5ea3a50d (commit)
      from  a2dbc20364f13ddd393e51e711db7e5e3bd2551f (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 f664bc1482edb6da965169317f04f2d7b6458fbd
Author: Jeremy C. Reed <jreed at ISC.org>
Date:   Wed Mar 2 11:48:45 2011 -0600

    [jreed-docs] miscellaneous docs

commit e241028cc0993fb87306bd097a45f99a5ea3a50d
Author: Jeremy C. Reed <jreed at ISC.org>
Date:   Wed Mar 2 11:48:12 2011 -0600

    [jreed-docs] need todo the configuration docs for bind10

-----------------------------------------------------------------------

Summary of changes:
 doc/guide/bind10-guide.xml |   54 +++++++++++++++++++++++++++++++-------------
 src/bin/bind10/bind10.xml  |    3 ++
 2 files changed, 41 insertions(+), 16 deletions(-)

-----------------------------------------------------------------------
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index 0935c81..c66e8f6 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -1212,10 +1212,9 @@ TODO
     <title>Incoming Zone Transfers</title>
 
     <para>
-      The <command>b10-xfrin</command> process is started by
-      <command>bind10</command>.
-      It can be manually triggered to request an AXFR zone
-      transfer. When received, it is stored in the BIND 10
+      Incoming zones are transferred using the <command>b10-xfrin</command>
+      process which is started by <command>bind10</command>.
+      When received, the zone is stored in the BIND 10
       data store, and its records can be served by
       <command>b10-auth</command>.
       In combination with <command>b10-zonemgr</command> (for
@@ -1226,8 +1225,22 @@ TODO
     <note><simpara>
      The current development release of BIND 10 only supports
      AXFR. (IXFR is not supported.) 
+
+<!-- TODO: sqlite3 data source only? -->
+
     </simpara></note>
 
+<!-- TODO:
+
+how to tell bind10 you are a secondary?
+
+when will it first attempt to check for new zone? (using REFRESH?)
+what if zonemgr is not running?
+
+what if a NOTIFY is sent?
+
+-->
+
     <para>
        To manually trigger a zone transfer to retrieve a remote zone,
        you may use the <command>bindctl</command> utility.
@@ -1236,6 +1249,9 @@ TODO
        <screen>> <userinput>Xfrin retransfer zone_name="<option>foo.example.org</option>" master=<option>192.0.2.99</option></userinput></screen>
     </para>
 
+<!-- TODO: can that retransfer be used to identify a new zone? -->
+<!-- TODO: what if doesn't exits at that master IP? -->
+
   </chapter>
 
   <chapter id="xfrout">
@@ -1342,28 +1358,34 @@ what is XfroutClient xfr_client??
 
 <!-- TODO: later the above will have some defaults -->
 
-    <para>
-      To enable forwarding, the upstream address and port must be
-      configured to forward queries to, such as:
+    <section>
+      <title>Forwarding</title>
 
-      <screen>
+      <para>
+
+        To enable forwarding, the upstream address and port must be
+        configured to forward queries to, such as:
+
+        <screen>
 > <userinput>config set Resolver/forward_addresses [{ "address": "<replaceable>192.168.1.1</replaceable>", "port": 53 }]</userinput>
 > <userinput>config commit</userinput>
 </screen>
 
-      (Replace <replaceable>192.168.1.1</replaceable> to point to your
-      full resolver.)
-    </para>
+        (Replace <replaceable>192.168.1.1</replaceable> to point to your
+        full resolver.)
+      </para>
 
-    <para>
-      Normal iterative name service can be re-enabled by clearing the
-      forwarding address(es); for example:
+      <para>
+        Normal iterative name service can be re-enabled by clearing the
+        forwarding address(es); for example:
 
-      <screen>
+        <screen>
 > <userinput>config set Resolver/forward_addresses []</userinput>
 > <userinput>config commit</userinput>
 </screen>
-    </para>
+      </para>
+
+    </section>
 
 <!-- TODO: later try this
 
diff --git a/src/bin/bind10/bind10.xml b/src/bin/bind10/bind10.xml
index dd8daf9..8ff059b 100644
--- a/src/bin/bind10/bind10.xml
+++ b/src/bin/bind10/bind10.xml
@@ -176,6 +176,9 @@ The default is the basename of ARG 0.
   </refsect1>
 
 <!--
+TODO: configuration section
+-->
+<!--
   <refsect1>
     <title>FILES</title>
     <para><filename></filename>