Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-30 21:21:22 +00:00
Code Issues Projects Releases Packages Wiki Activity

gh-119786: move adaptive interpreter doc from Python to InternalsDoc (#120137)

Browse source
This commit is contained in:
Irit Katriel 2024-06-06 11:56:58 +01:00 • committed by GitHub
parent f878d46e56
commit eeb8f67f83
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 7 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

1
InternalDocs/README.md
View file

@ -14,3 +14,4 @@ # CPython Internals Documentation
[Exception Handling](exception_handling.md) [Exception Handling](exception_handling.md)
[Adaptive Instruction Families](adaptive.md)

10
Python/adaptive.md → InternalDocs/adaptive.md
View file

@ -2,8 +2,9 @@ # Adding or extending a family of adaptive instructions.
## Families of instructions ## Families of instructions
The core part of PEP 659 (specializing adaptive interpreter) is the families The core part of [PEP 659](https://peps.python.org/pep-0659/)
of instructions that perform the adaptive specialization. (specializing adaptive interpreter) is the families of
instructions that perform the adaptive specialization.
A family of instructions has the following fundamental properties: A family of instructions has the following fundamental properties:
@ -30,8 +31,9 @@ ## Families of instructions
## Example family ## Example family
The `LOAD_GLOBAL` instruction (in Python/bytecodes.c) already has an adaptive The `LOAD_GLOBAL` instruction (in
family that serves as a relatively simple example. [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, The `LOAD_GLOBAL` instruction performs adaptive specialization,
calling `_Py_Specialize_LoadGlobal()` when the counter reaches zero. calling `_Py_Specialize_LoadGlobal()` when the counter reaches zero.