8000 bpo-44800: Document internal frame naming conventions by ncoghlan · Pull Request #32281 · python/cpython · GitHub
[go: up one dir, main page]

Skip to content

Conversation

@ncoghlan
Copy link
Contributor
@ncoghlan ncoghlan commented Apr 3, 2022

The fact interpreter frames were split out from full frame objects
rather than always being part of the eval loop implementation means
that it's tricky to infer the expected naming conventions simply
from looking at the code.

Documenting the de facto conventions in pycore_frame.h means future
readers of the code will have a clear explanation of the rationale
for those conventions (i.e. minimising non-functional code churn).

Closes bpo-44800

https://bugs.python.org/issue44800

The fact interpreter frames were split out from full frame objects
rather than always being part of the eval loop implementation means
that it's tricky to infer the expected naming conventions simply
from looking at the code.

Documenting the de facto conventions in pycore_frame.h means future
readers of the code will have a clear explanation of the rationale
for those conventions (i.e. minimising non-functional code churn).
@markshannon
Copy link
Member
markshannon commented Apr 4, 2022

@ncoghlan Please don't merge changes without review.

This change is both misleading in general and incorrect in detail, as I would have pointed out had you waited for a review rather than merging immediately.

@markshannon
Copy link
Member

See #32304

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

0