From: Phillip J. Eby <pje@telecommunity.com>
Date: Thu, 5 Aug 2004 12:13:46 +0000 (+0000)
Subject: Warn that settrace() is implementation rather than language
X-Git-Tag: v2.4a3~402
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1884dda2338adbfd7cd7b6954e7b5ce87cf7b0e1;p=python

Warn that settrace() is implementation rather than language
definition, per Guido's request  in off-list email.
---

diff --git a/Doc/lib/libsys.tex b/Doc/lib/libsys.tex
index 3b25e5aa41..2cac03e98a 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}