[2105] Document DT template parameter

diff --git a/src/lib/datasrc/memory/domaintree.h b/src/lib/datasrc/memory/domaintree.h
index 9f9e1659b60291fce3e71adc1f71ec1c71235f16..51d765cc4d17536e1756ff5abd6dbb6a13a84727 100644 (file)
--- a/src/lib/datasrc/memory/domaintree.h
+++ b/src/lib/datasrc/memory/domaintree.h
@@ -785,7 +785,7 @@ private:
  *
  *  \c DomainTree splits the domain space into hierarchy red black trees; nodes
  * in one tree has the same base name. The benefit of this struct is that:
- *  - Enhances the query performace compared with one big flat red black tree.
+ *  - Enhances the query performance compared with one big flat red black tree.
  *  - Decreases the memory footprint, as it doesn't store the suffix labels
  *      multiple times.
  *
@@ -800,6 +800,13 @@ private:
  * the \c insert() method will still return \c ALREADYEXISTS regardless of
  * the search policy.
  *
+ * The template parameters taken by \c DomainTree are \c T (the type of
+ * data which is stored by the tree) and \c DT (a type whose instance is
+ * used to destroy data stored in the tree). <code>operator()</code> is
+ * called on a \c DT instance and passed a pointer to the data
+ * (<code>T*</code>) to be destroyed. This method should be written to
+ * accept \c NULL arguments.
+ *
  * \anchor diagram
  *
  * with the following names: