merge adaptive.md into interpreter.md

Author: iritkatriel

Diff for: InternalDocs/README.md

@@ -33,9 +33,7 @@ Runtime Objects
 Program Execution
 ---
 
-- [The Basic Interpreter](interpreter.md)
-
-- [The Specializing Interpreter](adaptive.md)
+- [The Bytecode Interpreter](interpreter.md)
 
 - [The Tier 2 Interpreter and JIT](tier2.md)
 

Diff for: InternalDocs/adaptive.md

@@ -19,6 +19,11 @@ Code objects are typically produced by the bytecode [compiler](compiler.md),
 although they are often written to disk by one process and read back in by another.
 The disk version of a code object is serialized using the
 [marshal](https://docs.python.org/dev/library/marshal.html) protocol.
+When a [`CodeObject`](code_objects.md) is created, the function
+`_PyCode_Quicken()` from [`Python/specialize.c`](../Python/specialize.c) is
+called to initialize the caches of all adaptive instructions. This is
+required because the on-disk format is a sequence of bytes, and
+some of the caches need to be initialized with 16-bit values.
 
 Code objects are nominally immutable.
 Some fields (including `co_code_adaptive` and fields for runtime

Diff for: InternalDocs/code_objects.md

@@ -597,16 +597,6 @@ Objects
 * [Exception Handling](exception_handling.md): Describes the exception table
 
 
-Specializing Adaptive Interpreter
-=================================
-
-Adding a specializing, adaptive interpreter to CPython will bring significant
-performance improvements. These documents provide more information:
-
-* [PEP 659: Specializing Adaptive Interpreter](https://peps.python.org/pep-0659/).
-* [Adding or extending a family of adaptive instructions](adaptive.md)
-
-
 References
 ==========