From: JINMEI Tatuya <jinmei@isc.org>
Date: Mon, 12 Mar 2012 21:45:42 +0000 (-0700)
Subject: [1608] noted in doc that getAdditional() only returns in-zone data (+ glue).
X-Git-Tag: trac2351_base~226^2~116^2~127^2~3^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2cc4d39e5c74092c2fda2d9be3682b432243099b;p=thirdparty%2Fkea.git

[1608] noted in doc that getAdditional() only returns in-zone data (+ glue).
---

diff --git a/src/lib/datasrc/zone.h b/src/lib/datasrc/zone.h
index 361a03a605..c705279a95 100644
--- a/src/lib/datasrc/zone.h
+++ b/src/lib/datasrc/zone.h
@@ -252,6 +252,13 @@ public:
         /// call resulted in SUCCESS or DELEGATION.  Otherwise this method
         /// does nothing.
         ///
+        /// \note The additional RRsets returned via method are limited to
+        /// ones contained in the zone which the corresponding find/findAll
+        /// call searched (possibly including glues under a zone cut where
+        /// they are applicable).  If the caller needs to get out-of-zone
+        /// additional RRsets, it needs to explicitly finds them by
+        /// identifying the corresponding zone and calls \c find() for it.
+        ///
         /// \param requested_types A vector of RR types for desired additional
         ///  RRsets.
         /// \param result A vector to which any found additional RRsets are