Bug 9060: Minor update to inline documentation for new flag 06/62506/2
authorMichael Vorburger <vorburger@redhat.com>
Thu, 31 Aug 2017 16:19:47 +0000 (18:19 +0200)
committerRobert Varga <nite@hq.sk>
Fri, 1 Sep 2017 12:40:18 +0000 (12:40 +0000)
Change-Id: Id2eb1e76a8658e837166b227a30cd49ee665c258
Signed-off-by: Michael Vorburger <vorburger@redhat.com>
opendaylight/md-sal/mdsal-trace/api/src/main/resources/initial/mdsaltrace_config.xml
opendaylight/md-sal/mdsal-trace/api/src/main/yang/mdsaltrace.yang

index 13b5d86..9dfd362 100644 (file)
@@ -2,5 +2,12 @@
     <!-- <registration-watches>/neutron-router-dpns/router-dpn-list</registration-watches> -->
     <!-- <registration-watches>/tunnels_state/state-tunnel-list</registration-watches> -->
     <!-- <write-watches> /NetworkTopology/Topology</write-watches> -->
+
+    <!-- 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.
+         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 documentation has been copy/pasted from mdsaltrace.yang, and should be kept in line.] -->
     <transaction-debug-context-enabled>true</transaction-debug-context-enabled>
 </config>
index 5c6b09b..3761fa9 100644 (file)
@@ -29,7 +29,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.]
         }
     }
 }

©2013 OpenDaylight, A Linux Foundation Collaborative Project. All Rights Reserved.
OpenDaylight is a registered trademark of The OpenDaylight Project, Inc.
Linux Foundation and OpenDaylight are registered trademarks of the Linux Foundation.
Linux is a registered trademark of Linus Torvalds.