BIND 10 trac2877, updated. dd7864295bd032ad3a832a6ba7d35d13b89dc922 [2877] documented why we provide DEL_RNAME

[BIND 10 source code commits]

The branch, trac2877 has been updated
       via  dd7864295bd032ad3a832a6ba7d35d13b89dc922 (commit)
      from  f8af3f0612dd39b81283af83b5a930d0754dacf8 (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 dd7864295bd032ad3a832a6ba7d35d13b89dc922
Author: JINMEI Tatuya <jinmei at isc.org>
Date:   Mon Apr 8 11:26:17 2013 -0700

    [2877] documented why we provide DEL_RNAME

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

Summary of changes:
 src/lib/datasrc/database.h |    9 +++++++++
 1 file changed, 9 insertions(+)

-----------------------------------------------------------------------
diff --git a/src/lib/datasrc/database.h b/src/lib/datasrc/database.h
index 0fd36d3..eb77666 100644
--- a/src/lib/datasrc/database.h
+++ b/src/lib/datasrc/database.h
@@ -122,6 +122,15 @@ public:
     /// Each derived implementation of deleteRecordInZone() should expect
     /// the "params" array to be filled with the values as described in this
     /// enumeration, in this order.
+    ///
+    /// DEL_RNAME is included in case the reversed from is more convenient
+    /// for the underlying implementation to identify the record to be
+    /// deleted (reversed names are generally easier to sort, which may help
+    /// perform the search faster).  It's up to the underlying implementation
+    /// which one (or both) it uses for the search.   DEL_NAME and DEL_RNAME
+    /// are mutually convertible with the understanding of DNS names, and
+    /// in that sense redundant.  But both are provided so the underlying
+    /// implementation doesn't have to deal with DNS level concepts.
     enum DeleteRecordParams {
         DEL_NAME = 0, ///< The owner name of the record (a domain name)
                       ///< or the hash label for deleteNSEC3RecordInZone()