From 1884dda2338adbfd7cd7b6954e7b5ce87cf7b0e1 Mon Sep 17 00:00:00 2001
From: "Phillip J. Eby" <pje@telecommunity.com>
Date: Thu, 5 Aug 2004 12:13:46 +0000
Subject: [PATCH] Warn that settrace() is implementation rather than language
 definition, per Guido's request  in off-list email.

---
 Doc/lib/libsys.tex | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

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}
-- 
2.50.1