[2432] Document whether rrsets can be modified after being added

diff --git a/src/lib/dns/rrset_collection.h b/src/lib/dns/rrset_collection.h
index ba68dc5ce1b2a41b673d15cd72d3052f31e6aa2d..fe9152c22e0f9fcd073bbc6bf2225eb19d61214c 100644 (file)
--- a/src/lib/dns/rrset_collection.h
+++ b/src/lib/dns/rrset_collection.h
@@ -77,6 +77,10 @@ public:
     /// and managed by the \c RRsetCollection. It throws an
     /// \c isc::InvalidParameter exception if an rrset with the same
     /// class, type and name already exists.
+    ///
+    /// Callers must not modify the RRset after adding it to the
+    /// collection, as the rrset is indexed internally by the
+    /// collection.
     void addRRset(isc::dns::RRsetPtr rrset);
 
     /// \brief Remove an RRset from the collection.