[2435] Explain why using the rrset collection is not allowed after calling ZoneUpdate...

diff --git a/src/lib/datasrc/zone.h b/src/lib/datasrc/zone.h
index 45f7545b2e1eb16f67735a26e2b7543261b090d1..3b720ae96c0c5411a27b0db787895b9cab36b5cd 100644 (file)
--- a/src/lib/datasrc/zone.h
+++ b/src/lib/datasrc/zone.h
@@ -825,9 +825,11 @@ public:
     /// because iterating the collection may result in unexpected
     /// behavior if the underlying data is updated.  Implementations of
     /// \c ZoneUpdater may disable a previously returned
-    /// \c RRsetCollection after \c commit() is called. If an
-    /// \c RRsetCollection is disabled, using methods such as \c find() and
-    /// using its iterator would cause an exception to be thrown. See
+    /// \c RRsetCollection after \c commit() is called. Even in this
+    /// case, using existing iterators may result in unexpected behavior
+    /// after \c commit() is called. If an \c RRsetCollection is
+    /// disabled, using methods such as \c find() and using its iterator
+    /// would cause an exception to be thrown. See
     /// \c isc::datasrc::RRsetCollectionBase for details.
     virtual isc::datasrc::RRsetCollectionBase& getRRsetCollection() = 0;