docs/library/sys.rst: Add docs for sys.settrace.

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/library/sys.rst b/docs/library/sys.rst
index 24f9e353b..80ac1ab84 100644
--- a/docs/library/sys.rst
+++ b/docs/library/sys.rst
@@ -43,6 +43,15 @@ Functions
       positional; further arguments are not supported. CPython-compatible
       ``traceback`` module can be found in `micropython-lib`.
 
+.. function:: settrace(tracefunc)
+
+   Enable tracing of bytecode execution.  For details see the `CPython
+   documentaion <https://docs.python.org/3/library/sys.html#sys.settrace>`_.
+
+   This function requires a custom MicroPython build as it is typically not
+   present in pre-built firmware (due to it affecting performance).  The relevant
+   configuration option is *MICROPY_PY_SYS_SETTRACE*.
+
 Constants
 ---------