summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPhillip J. Eby <pje@telecommunity.com>2004-08-05 12:13:46 (GMT)
committerPhillip J. Eby <pje@telecommunity.com>2004-08-05 12:13:46 (GMT)
commit1884dda2338adbfd7cd7b6954e7b5ce87cf7b0e1 (patch)
tree7a2d6f5b6863f417375821fc2960153adf2b4138
parentcf6fc7906d5abb6e0b9e7e52c94e8b28883672f7 (diff)
downloadcpython-1884dda2338adbfd7cd7b6954e7b5ce87cf7b0e1.zip
cpython-1884dda2338adbfd7cd7b6954e7b5ce87cf7b0e1.tar.gz
cpython-1884dda2338adbfd7cd7b6954e7b5ce87cf7b0e1.tar.bz2
Warn that settrace() is implementation rather than language
definition, per Guido's request in off-list email.
-rw-r--r--Doc/lib/libsys.tex6
1 files changed, 5 insertions, 1 deletions
diff --git a/Doc/lib/libsys.tex b/Doc/lib/libsys.tex
index 3b25e5a..2cac03e 100644
--- a/Doc/lib/libsys.tex
+++ b/Doc/lib/libsys.tex
@@ -475,7 +475,11 @@ else:
the Python debugger.\index{debugger} The function is
thread-specific; for a debugger to support multiple threads, it must
be registered using \function{settrace()} for each thread being
- debugged.
+ debugged. \note{The \function{settrace()} function is intended only
+ for implementing debuggers, profilers, coverage tools and the like.
+ Its behavior is part of the implementation platform, rather than
+ part of the language definition, and thus may not be available in
+ all Python implementations.}
\end{funcdesc}
\begin{funcdesc}{settscdump}{on_flag}