diff options
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/lib/libpdb.tex | 12 | ||||
-rw-r--r-- | Doc/libpdb.tex | 12 |
2 files changed, 20 insertions, 4 deletions
diff --git a/Doc/lib/libpdb.tex b/Doc/lib/libpdb.tex index 9785a40..fcd8849 100644 --- a/Doc/lib/libpdb.tex +++ b/Doc/lib/libpdb.tex @@ -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: diff --git a/Doc/libpdb.tex b/Doc/libpdb.tex index 9785a40..fcd8849 100644 --- a/Doc/libpdb.tex +++ b/Doc/libpdb.tex @@ -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: |