BIND 10 trac1431, updated. 2b16771b9cd34d55fe3916669b53531b29bdf0ce [1431] some more clarification in documentation based on review comments

[BIND 10 source code commits]

The branch, trac1431 has been updated
       via  2b16771b9cd34d55fe3916669b53531b29bdf0ce (commit)
      from  91a26d94d9a0b70a030d79f7e927610c1e745878 (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 2b16771b9cd34d55fe3916669b53531b29bdf0ce
Author: JINMEI Tatuya <jinmei at isc.org>
Date:   Fri Jan 20 10:32:53 2012 -0800

    [1431] some more clarification in documentation based on review comments

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

Summary of changes:
 src/lib/datasrc/zone.h |   11 +++++++----
 1 files changed, 7 insertions(+), 4 deletions(-)

-----------------------------------------------------------------------
diff --git a/src/lib/datasrc/zone.h b/src/lib/datasrc/zone.h
index 6e53f67..9e83286 100644
--- a/src/lib/datasrc/zone.h
+++ b/src/lib/datasrc/zone.h
@@ -407,13 +407,16 @@ public:
     ///
     /// In general, this method expects the zone is properly signed with NSEC3
     /// RRs.  Specifically, it assumes at least the apex node has a matching
-    /// NSEC3 RR.  So the search must always succeed; if the assumption isn't
-    /// met, \c DataSourceError exception will be thrown.
+    /// NSEC3 RR (so the search in the recursive mode must always succeed);
+    /// it also assumes that it can retrieve NSEC parameters (iterations,
+    /// algorithm, and salt) from the zone as noted above.  If these
+    /// assumptions aren't met, \c DataSourceError exception will be thrown.
     ///
     /// \exception InvalidParameter name is not a subdomain of the zone origin;
     /// known_encloser does not meet the requirement (see above)
-    /// \exception DataSourceError The zone isn't properly signed with NSEC3
-    /// (NSEC3 parameters cannot be found; no NSEC3s are available, etc).
+    /// \exception DataSourceError Low-level or internal datasource errors
+    /// happened, or the zone isn't properly signed with NSEC3
+    /// (NSEC3 parameters cannot be found, no NSEC3s are available, etc).
     /// \exception std::bad_alloc The underlying implementation involves
     /// memory allocation and it fails
     ///