From cb3c0ff72b41ee6b4256d5417383b83585088357 Mon Sep 17 00:00:00 2001
From: Stan Ulbrych <stanulbrych@gmail.com>
Date: Sun, 21 Sep 2025 09:55:10 +0100
Subject: [PATCH] Commit

---
 Tools/README              | 17 +++++++++++++++--
 Tools/scripts/README      | 11 ++++++++++-
 Tools/scripts/sortperf.py |  2 +-
 3 files changed, 26 insertions(+), 4 deletions(-)

diff --git a/Tools/README b/Tools/README
index 09bd6fb4798950..58001b7f635a87 100644
--- a/Tools/README
+++ b/Tools/README
@@ -16,6 +16,9 @@ clinic          A preprocessor for CPython C files in order to automate
 
 freeze          Create a stand-alone executable from a Python program.
 
+ftscalingbench  Runs a set of small benchmarks to help identify scaling
+                bottlenecks in the free-threaded interpreter.
+
 gdb             Python code to be run inside gdb, to make it easier to
                 debug Python itself (by David Malcolm).
 
@@ -26,6 +29,14 @@ i18n            Tools for internationalization. pygettext.py
 
 importbench     A set of micro-benchmarks for various import scenarios.
 
+inspection      A set of benchmarks to measure get_stack_trace() performance.
+
+jit             Documentation and tools for building the JIT compiler. See
+                jit/README.md for more information.
+
+lockbench       Benchmarks to measure the performance of PyMutex and
+                PyThread_type_lock locks with short critical sections.
+
 msi             Support for packaging Python as an MSI package on Windows.
 
 nuget           Files for the NuGet package manager for .NET.
@@ -35,12 +46,14 @@ patchcheck      Tools for checking and applying patches to the Python source cod
 
 peg_generator   PEG-based parser generator (pegen) used for new parser.
 
-scripts         A number of useful single-file programs, e.g. run_tests.py
-                which runs the Python test suite.
+scripts         A number of useful single-file programs. See scripts/README for
+                more information.
 
 ssl             Scripts to generate ssl_data.h from OpenSSL sources, and run
                 tests against multiple installations of OpenSSL and LibreSSL.
 
+tsan            Files that contain suppressions for TSan.
+
 tz              A script to dump timezone from /usr/share/zoneinfo.
 
 unicode         Tools for generating unicodedata and codecs from unicode.org
diff --git a/Tools/scripts/README b/Tools/scripts/README
index a078bfbf662a37..37a5f72a3b67fe 100644
--- a/Tools/scripts/README
+++ b/Tools/scripts/README
@@ -3,13 +3,22 @@ useful while building, extending or managing Python.
 
 checkpip.py               Checks the version of the projects bundled in ensurepip
                           are the latest available
+
 combinerefs.py            A helper for analyzing PYTHONDUMPREFS output
+
 divmod_threshold.py       Determine threshold for switching from longobject.c
                           divmod to _pylong.int_divmod()
+
 idle3                     Main program to start IDLE
+
+long_conv_tables.py       Compute tables for longobject.c long_from_non_binary_base()
+
 pydoc3                    Python documentation browser
-run_tests.py              Run the test suite with more sensible default options
+
+sortperf.py               List sort performance test, requires the pyperf module.
+
 summarize_stats.py        Summarize specialization stats for all files in the
                           default stats folders
+
 var_access_benchmark.py   Show relative speeds of local, nonlocal, global,
                           and built-in access
diff --git a/Tools/scripts/sortperf.py b/Tools/scripts/sortperf.py
index 1978a6c83dbe2b..117be9a950b1dc 100644
--- a/Tools/scripts/sortperf.py
+++ b/Tools/scripts/sortperf.py
@@ -7,7 +7,7 @@
 
 To run:
 
-    python3 Tools/scripts/sortperf
+    python3 Tools/scripts/sortperf.py
 
 Options: