summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorIrit Katriel <1055913+iritkatriel@users.noreply.github.com>2024-06-06 10:56:58 (GMT)
committerGitHub <noreply@github.com>2024-06-06 10:56:58 (GMT)
commiteeb8f67f837facb37f092a8b743f4d249515e82f (patch)
tree3312f7435dcc39c8efd091ef472b90e8ef0e27ac
parentf878d46e5614f08a9302fcb6fc611ef49e9acf2f (diff)
downloadcpython-eeb8f67f837facb37f092a8b743f4d249515e82f.zip
cpython-eeb8f67f837facb37f092a8b743f4d249515e82f.tar.gz
cpython-eeb8f67f837facb37f092a8b743f4d249515e82f.tar.bz2
gh-119786: move adaptive interpreter doc from Python to InternalsDoc (#120137)
-rw-r--r--InternalDocs/README.md1
-rw-r--r--InternalDocs/adaptive.md (renamed from Python/adaptive.md)10
2 files changed, 7 insertions, 4 deletions
diff --git a/InternalDocs/README.md b/InternalDocs/README.md
index e69e27d..a2502fb 100644
--- a/InternalDocs/README.md
+++ b/InternalDocs/README.md
@@ -14,3 +14,4 @@ it is not, please report that through the
[Exception Handling](exception_handling.md)
+[Adaptive Instruction Families](adaptive.md)
diff --git a/Python/adaptive.md b/InternalDocs/adaptive.md
index d978c08..0924573 100644
--- a/Python/adaptive.md
+++ b/InternalDocs/adaptive.md
@@ -2,8 +2,9 @@
## Families of instructions
-The core part of PEP 659 (specializing adaptive interpreter) is the families
-of instructions that perform the adaptive specialization.
+The core part of [PEP 659](https://peps.python.org/pep-0659/)
+(specializing adaptive interpreter) is the families of
+instructions that perform the adaptive specialization.
A family of instructions has the following fundamental properties:
@@ -30,8 +31,9 @@ although these are not fundamental and may change:
## Example family
-The `LOAD_GLOBAL` instruction (in Python/bytecodes.c) already has an adaptive
-family that serves as a relatively simple example.
+The `LOAD_GLOBAL` instruction (in
+[Python/bytecodes.c](https://github.com/python/cpython/blob/main/Python/bytecodes.c))
+already has an adaptive family that serves as a relatively simple example.
The `LOAD_GLOBAL` instruction performs adaptive specialization,
calling `_Py_Specialize_LoadGlobal()` when the counter reaches zero.