gh-119786: move interpreter doc from devguide to InternalDocs (#125715)

python · Oct 21, 2024 · 695814c · 695814c
1 parent 9b0bfba
commit 695814c
Show file tree

Hide file tree

Showing 4 changed files with 400 additions and 9 deletions.
diff --git a/InternalDocs/README.md b/InternalDocs/README.md
@@ -11,19 +11,32 @@ The core dev team attempts to keep this documentation up to date. If
 it is not, please report that through the
 [issue tracker](https://github.com/python/cpython/issues).
 
-Index:
------
 
-[Guide to the parser](parser.md)
+Compiling Python Source Code
+---
 
-[Compiler Design](compiler.md)
+- [Guide to the parser](parser.md)
 
-[Frames](frames.md)
+- [Compiler Design](compiler.md)
 
-[Adaptive Instruction Families](adaptive.md)
+Runtime Objects
+---
 
-[The Source Code Locations Table](locations.md)
+- [Code Objects (coming soon)](code_objects.md)
 
-[Garbage collector design](garbage_collector.md)
+- [The Source Code Locations Table](locations.md)
 
-[Exception Handling](exception_handling.md)
+- [Generators (coming soon)](generators.md)
+
+- [Frames](frames.md)
+
+Program Execution
+---
+
+- [The Interpreter](interpreter.md)
+
+- [Adaptive Instruction Families](adaptive.md)
+
+- [Garbage Collector Design](garbage_collector.md)
+
+- [Exception Handling](exception_handling.md)
diff --git a/InternalDocs/code_objects.md b/InternalDocs/code_objects.md
@@ -0,0 +1,5 @@
+
+Code objects
+============ 
+
+Coming soon.
diff --git a/InternalDocs/generators.md b/InternalDocs/generators.md
@@ -0,0 +1,9 @@
+
+Generators
+========== 
+
+Coming soon.
+
+<!--
+- Generators, async functions, async generators, and ``yield from`` (next, send, throw, close; and await; and how this code breaks the interpreter abstraction)
+-->