From 2e52a652230874f705bdf0a1e8abf918f3b2c809 Mon Sep 17 00:00:00 2001 From: manus Date: Tue, 15 Nov 2011 18:48:27 +0000 Subject: [PATCH] Added a warning about the usage of TRACING_SETTING to avoid unexpected results. Author:manus Date:2011-11-15T18:48:27.000000Z git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@1011 abb3cda0-5349-4a8f-a601-0c33ac3a8c38 --- .../running-and-debugging/tracing.wiki | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/documentation/current/eiffelstudio/eiffelstudio-how-tos/running-and-debugging/tracing.wiki b/documentation/current/eiffelstudio/eiffelstudio-how-tos/running-and-debugging/tracing.wiki index 74d727f9..a09040ec 100644 --- a/documentation/current/eiffelstudio/eiffelstudio-how-tos/running-and-debugging/tracing.wiki +++ b/documentation/current/eiffelstudio/eiffelstudio-how-tos/running-and-debugging/tracing.wiki @@ -67,6 +67,9 @@ In the root feature: ps.disable_tracing -- Program execution continues. ... + + -- Restore tracing before exiting for proper cleanup. + ps.enable_tracing end @@ -86,6 +89,7 @@ Then, in a feature in which tracing is desired: end +{{warning| Enabling/disabling tracing as shown above has to be done within the same routine otherwise the computed depth would be inaccurate and this would cause some unpredictable results.}} =Using a trace handler= @@ -112,7 +116,9 @@ To make this facility more approachable for common tasks, EiffelBase also contai -- Trigger a trace operation from a feature represented by `a_feature_name' defined in -- class `a_class_name' and applied to an object of type `a_type' at a call depth `a_depth'. -- If `a_is_entering' we are entering the routine, otherwise we are exiting it. - deferred + require + a_depth_non_negative: a_depth >= 0 + deferred end