Bug 9060: Minor mdsaltrace_config.xml /this/will/never/exist
[controller.git] / opendaylight / md-sal / mdsal-trace / api / src / main / yang / mdsaltrace.yang
index 5c6b09b5bf9db531d01e3b7ff48964ecc1c42b5e..60e0d914a9a5af06524747e3ab869d9d8dc3adff 100644 (file)
@@ -18,7 +18,6 @@ module mdsaltrace {
     }
 
     container config {
-        // TODO leaf enabled ...
         leaf-list registration-watches {
             type string;
         }
@@ -29,7 +28,11 @@ module mdsaltrace {
             default false;
             type boolean;
             description "Enable or disable transaction context debug. This will preserve the call site trace for
-                         transactions, so that the original caller of un-close'd() transaction can be identified";
+                         transactions, so that the original caller of un-close'd() transaction can be identified.
+                         NB: This is a different property from the equally named one in etc/org.opendaylight.controller.cluster.datastore.cfg;
+                         that one does something somewhat similar, but serves to include the stack trace on failed transaction submit,
+                         whereas this one is specific to odl-mdsal-trace's trace:transaction leak troubleshooting command.";
+            // This ^^^ description is also copy/pasted in mdsaltrace_config.xml, and should be kept in line.]
         }
     }
 }