diff options
| author | Irit Katriel <1055913+iritkatriel@users.noreply.github.com> | 2024-06-19 16:58:54 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-06-19 16:58:54 (GMT) |
| commit | d484383861b44b4cf76f31ad6af9a0b413334a89 (patch) | |
| tree | 8a4049a7ebc0a28beaa4a3641516e3e04c68fb77 | |
| parent | d1c673b658977a8e6236feee579308e0ed6a0187 (diff) | |
| download | cpython-d484383861b44b4cf76f31ad6af9a0b413334a89.zip cpython-d484383861b44b4cf76f31ad6af9a0b413334a89.tar.gz cpython-d484383861b44b4cf76f31ad6af9a0b413334a89.tar.bz2 | |
gh-119786: move locations doc to InternalDocs (#120445)
| -rw-r--r-- | InternalDocs/README.md | 6 | ||||
| -rw-r--r-- | InternalDocs/locations.md (renamed from Objects/locations.md) | 8 |
2 files changed, 8 insertions, 6 deletions
diff --git a/InternalDocs/README.md b/InternalDocs/README.md index 42f6125..2918ead 100644 --- a/InternalDocs/README.md +++ b/InternalDocs/README.md @@ -14,6 +14,8 @@ it is not, please report that through the [Compiler Design](compiler.md) -[Exception Handling](exception_handling.md) - [Adaptive Instruction Families](adaptive.md) + +[The Source Code Locations Table](locations.md) + +[Exception Handling](exception_handling.md) diff --git a/Objects/locations.md b/InternalDocs/locations.md index 18a338a..91a7824 100644 --- a/Objects/locations.md +++ b/InternalDocs/locations.md @@ -1,10 +1,10 @@ # Locations table -For versions up to 3.10 see ./lnotab_notes.txt +The `co_linetable` bytes object of code objects contains a compact +representation of the source code positions of instructions, which are +returned by the `co_positions()` iterator. -In version 3.11 the `co_linetable` bytes object of code objects contains a compact representation of the positions returned by the `co_positions()` iterator. - -The `co_linetable` consists of a sequence of location entries. +`co_linetable` consists of a sequence of location entries. Each entry starts with a byte with the most significant bit set, followed by zero or more bytes with most significant bit unset. Each entry contains the following information: |