]> granicus.if.org Git - python/commitdiff
Small wording change about global and local trace functions.
authorGuido van Rossum <guido@python.org>
Mon, 27 Oct 1997 19:57:20 +0000 (19:57 +0000)
committerGuido van Rossum <guido@python.org>
Mon, 27 Oct 1997 19:57:20 +0000 (19:57 +0000)
Doc/lib/libpdb.tex
Doc/libpdb.tex

index 9785a406d3f026aa17aa275eac3be7f4f6946f83..fcd8849d20635dd20d6cf72c36b39505656c5207 100644 (file)
@@ -258,8 +258,16 @@ or \code{'exception'}
 
 \end{description}
 
-A trace function should return a new trace function or None.
-Class methods are accepted (and most useful!) as trace methods.
+The global trace function is invoked (with \var{event} set to
+\code{'call'}) whenever a new local scope is entered; it should return
+a reference to the local trace function to be used that scope, or
+\code{None} if the scope shouldn't be traced.
+
+The local trace function should return a reference to itself (or to
+another function for further tracing in that scope), or \code{None} to
+turn off tracing in that scope.
+
+Instance methods are accepted (and very useful!) as trace functions.
 
 The events have the following meaning:
 
index 9785a406d3f026aa17aa275eac3be7f4f6946f83..fcd8849d20635dd20d6cf72c36b39505656c5207 100644 (file)
@@ -258,8 +258,16 @@ or \code{'exception'}
 
 \end{description}
 
-A trace function should return a new trace function or None.
-Class methods are accepted (and most useful!) as trace methods.
+The global trace function is invoked (with \var{event} set to
+\code{'call'}) whenever a new local scope is entered; it should return
+a reference to the local trace function to be used that scope, or
+\code{None} if the scope shouldn't be traced.
+
+The local trace function should return a reference to itself (or to
+another function for further tracing in that scope), or \code{None} to
+turn off tracing in that scope.
+
+Instance methods are accepted (and very useful!) as trace functions.
 
 The events have the following meaning: