BIND 10 trac2054, updated. dca052ba19feab373ef9c36e929abd19c663e051 [2054] suggested doc update for nodeFission().

[BIND 10 source code commits]

The branch, trac2054 has been updated
       via  dca052ba19feab373ef9c36e929abd19c663e051 (commit)
      from  72539e992045e3b5b733d32660b6b939e5c67015 (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 dca052ba19feab373ef9c36e929abd19c663e051
Author: JINMEI Tatuya <jinmei at isc.org>
Date:   Wed Aug 1 00:07:02 2012 -0700

    [2054] suggested doc update for nodeFission().
    
    Its semantics has been changed, so the doc must be updated.

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

Summary of changes:
 src/lib/datasrc/rbtree.h |    9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

-----------------------------------------------------------------------
diff --git a/src/lib/datasrc/rbtree.h b/src/lib/datasrc/rbtree.h
index 7b186ca..d7b7e78 100644
--- a/src/lib/datasrc/rbtree.h
+++ b/src/lib/datasrc/rbtree.h
@@ -1277,10 +1277,11 @@ private:
 
     /// Split one node into two nodes for "prefix" and "suffix" parts of
     /// the labels of the original node, respectively.  The given node
-    /// will hold the suffix labels, while the new node will hold the prefix.
-    /// The newly created node represents the labels that the original node
-    /// did, so necessary data are swapped.
-    /// (Note: as commented in the code, this behavior should be changed).
+    /// will hold the prefix, while a newly created node will hold the prefix.
+    /// Note that the original node still represents the same domain name in
+    /// the entire tree.  This ensures that a pointer to a node keeps its
+    /// semantics even if the tree structure is changed (as long as the node
+    /// itself remains valid).
     void nodeFission(util::MemorySegment& mem_sgmt, RBNode<T>& node,
                      const isc::dns::LabelSequence& new_prefix,
                      const isc::dns::LabelSequence& new_suffix);