Skip to content

Minor fixes to C API docs #31501

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Feb 23, 2022
Merged

Minor fixes to C API docs #31501

merged 5 commits into from
Feb 23, 2022

Conversation

JelleZijlstra
Copy link
Member

Various things I noticed while reading through the C API docs.
Happy to back out any changes or create an issue if anything
turns out to be controversial.

  • C API docs: move PyErr_SetImportErrorSubclass docs
  • C API docs: document closeit argument to PyRun_AnyFileExFlags
  • textual fixes to unicode docs
  • Move paragraph about tp_dealloc into tp_dealloc section
  • aiter returns an async iterator, not an awaitable

@JelleZijlstra
Copy link
Member Author

@gvanrossum I'm planning to merge this PR (docs change by myself, approved by Andrew).

Copy link
Member

@gvanrossum gvanrossum left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Green light!

@JelleZijlstra JelleZijlstra merged commit 43cf44d into python:main Feb 23, 2022
@miss-islington
Copy link
Contributor

Thanks @JelleZijlstra for the PR 🌮🎉.. I'm working now to backport this PR to: 3.9, 3.10.
🐍🍒⛏🤖

@JelleZijlstra JelleZijlstra deleted the capi branch February 23, 2022 04:34
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 23, 2022
* C API docs: move PyErr_SetImportErrorSubclass docs

It was in the section about warnings, but it makes more sense to
put it with PyErr_SetImportError.

* C API docs: document closeit argument to PyRun_AnyFileExFlags

It was already documented for PyRun_SimpleFileExFlags.

* textual fixes to unicode docs

* Move paragraph about tp_dealloc into tp_dealloc section

* __aiter__ returns an async iterator, not an awaitable
(cherry picked from commit 43cf44d)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
@miss-islington
Copy link
Contributor

Sorry, @JelleZijlstra, I could not cleanly backport this to 3.9 due to a conflict.
Please backport using cherry_picker on command line.
cherry_picker 43cf44ddcce6b225f959ea2a53e4817244ca6054 3.9

@bedevere-bot
Copy link

GH-31524 is a backport of this pull request to the 3.10 branch.

@bedevere-bot
Copy link

GH-31526 is a backport of this pull request to the 3.9 branch.

JelleZijlstra added a commit to JelleZijlstra/cpython that referenced this pull request Feb 23, 2022
* C API docs: move PyErr_SetImportErrorSubclass docs

It was in the section about warnings, but it makes more sense to
put it with PyErr_SetImportError.

* C API docs: document closeit argument to PyRun_AnyFileExFlags

It was already documented for PyRun_SimpleFileExFlags.

* textual fixes to unicode docs

* Move paragraph about tp_dealloc into tp_dealloc section

* __aiter__ returns an async iterator, not an awaitable.
(cherry picked from commit 43cf44d)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
miss-islington added a commit that referenced this pull request Feb 23, 2022
* C API docs: move PyErr_SetImportErrorSubclass docs

It was in the section about warnings, but it makes more sense to
put it with PyErr_SetImportError.

* C API docs: document closeit argument to PyRun_AnyFileExFlags

It was already documented for PyRun_SimpleFileExFlags.

* textual fixes to unicode docs

* Move paragraph about tp_dealloc into tp_dealloc section

* __aiter__ returns an async iterator, not an awaitable
(cherry picked from commit 43cf44d)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
JelleZijlstra added a commit that referenced this pull request Mar 2, 2022
* C API docs: move PyErr_SetImportErrorSubclass docs

It was in the section about warnings, but it makes more sense to
put it with PyErr_SetImportError.

* C API docs: document closeit argument to PyRun_AnyFileExFlags

It was already documented for PyRun_SimpleFileExFlags.

* textual fixes to unicode docs

* Move paragraph about tp_dealloc into tp_dealloc section

* __aiter__ returns an async iterator, not an awaitable.
(cherry picked from commit 43cf44d)
hello-adam pushed a commit to hello-adam/cpython that referenced this pull request Jun 2, 2022
* C API docs: move PyErr_SetImportErrorSubclass docs

It was in the section about warnings, but it makes more sense to
put it with PyErr_SetImportError.

* C API docs: document closeit argument to PyRun_AnyFileExFlags

It was already documented for PyRun_SimpleFileExFlags.

* textual fixes to unicode docs

* Move paragraph about tp_dealloc into tp_dealloc section

* __aiter__ returns an async iterator, not an awaitable.
(cherry picked from commit 43cf44d)
rhansen added a commit to rhansen/cpython that referenced this pull request Oct 19, 2024
It looks like commit 43cf44d
(pythongh-31501) accidentally moved the paragraph to the `tp_finalize`
section when the intent was to move it to the `tp_dealloc` section
(according to the commit message).

Also:
  * Convert the paragraph to a warning.
  * Apply the appropriate font style to `tp_dealloc`.
  * Unlinkify the first mention of `tp_dealloc` since the paragraph is
    already in the `tp_dealloc` section.
JelleZijlstra pushed a commit that referenced this pull request Oct 21, 2024
)

It looks like commit 43cf44d
(gh-31501) accidentally moved the paragraph to the `tp_finalize`
section when the intent was to move it to the `tp_dealloc` section
(according to the commit message).

Also:
  * Convert the paragraph to a warning.
  * Apply the appropriate font style to `tp_dealloc`.
  * Unlinkify the first mention of `tp_dealloc` since the paragraph is
    already in the `tp_dealloc` section.
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Oct 21, 2024
…onGH-125737)

It looks like commit 43cf44d
(pythongh-31501) accidentally moved the paragraph to the `tp_finalize`
section when the intent was to move it to the `tp_dealloc` section
(according to the commit message).

(cherry picked from commit d880c83)

Co-authored-by: Richard Hansen <rhansen@rhansen.org>
Also: * Convert the paragraph to a warning.
  * Apply the appropriate font style to `tp_dealloc`.
  * Unlinkify the first mention of `tp_dealloc` since the paragraph is
    already in the `tp_dealloc` section.
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Oct 21, 2024
…onGH-125737)

It looks like commit 43cf44d
(pythongh-31501) accidentally moved the paragraph to the `tp_finalize`
section when the intent was to move it to the `tp_dealloc` section
(according to the commit message).

(cherry picked from commit d880c83)

Co-authored-by: Richard Hansen <rhansen@rhansen.org>
Also: * Convert the paragraph to a warning.
  * Apply the appropriate font style to `tp_dealloc`.
  * Unlinkify the first mention of `tp_dealloc` since the paragraph is
    already in the `tp_dealloc` section.
JelleZijlstra pushed a commit that referenced this pull request Oct 21, 2024
GH-125737) (#125799)

Doc: C API: Move `tp_dealloc` paragraph to `tp_dealloc` section (GH-125737)

It looks like commit 43cf44d
(gh-31501) accidentally moved the paragraph to the `tp_finalize`
section when the intent was to move it to the `tp_dealloc` section
(according to the commit message).

(cherry picked from commit d880c83)

Co-authored-by: Richard Hansen <rhansen@rhansen.org>
JelleZijlstra pushed a commit that referenced this pull request Oct 21, 2024
GH-125737) (#125798)


It looks like commit 43cf44d
(gh-31501) accidentally moved the paragraph to the `tp_finalize`
section when the intent was to move it to the `tp_dealloc` section
(according to the commit message).

(cherry picked from commit d880c83)


Co-authored-by: Richard Hansen <rhansen@rhansen.org>
ebonnal pushed a commit to ebonnal/cpython that referenced this pull request Jan 12, 2025
…on#125737)

It looks like commit 43cf44d
(pythongh-31501) accidentally moved the paragraph to the `tp_finalize`
section when the intent was to move it to the `tp_dealloc` section
(according to the commit message).

Also:
  * Convert the paragraph to a warning.
  * Apply the appropriate font style to `tp_dealloc`.
  * Unlinkify the first mention of `tp_dealloc` since the paragraph is
    already in the `tp_dealloc` section.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir skip issue skip news
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants