Skip to content

gh-87969: Amend docs and docstrings for ctypes.string_at and ctypes.wstring_at #25384

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 7 commits into from
Apr 18, 2024

Conversation

shreyanavigyan
Copy link
Contributor

@shreyanavigyan shreyanavigyan commented Apr 13, 2021

The docstrings, docs and argument lists of the functions ctypes.string_at and ctypes.wstring_at used different names to refer to the first argument. Changing them to only use the name "ptr" to refer to the first argument.

https://bugs.python.org/issue43803

@github-actions
Copy link

This PR is stale because it has been open for 30 days with no activity.

@github-actions github-actions bot added the stale Stale PR or inactive for long period of time. label Jun 13, 2021
@shreyanavigyan
Copy link
Contributor Author

Friendly Ping

@FFY00
Copy link
Member

FFY00 commented Jun 13, 2021

@iritkatriel would you mind having a look? This is fairly straightforward, currently the documentation is wrong and does not correctly represent the code. This should probably also get backported to older versions.

@github-actions github-actions bot removed the stale Stale PR or inactive for long period of time. label Jun 14, 2021
@erlend-aasland erlend-aasland changed the title bpo-43803: Updating docs and docstrings of the functions ctypes.string_at and ctypes.wstring_at to use the name "ptr" to refer to the first argument gh-87969: Amend docs and docstrings for ctypes.string_at and ctypes.wstring_at Jun 22, 2023
@arhadthedev arhadthedev added needs backport to 3.11 only security fixes needs backport to 3.12 only security fixes labels Jun 22, 2023
@erlend-aasland
Copy link
Contributor

erlend-aasland commented Jun 22, 2023

I've cleaned up the PR, and addressed Irit's remark about Eryc's remark. I consider it ok to land this, so I'm enabling auto-merge.

@erlend-aasland erlend-aasland enabled auto-merge (squash) June 22, 2023 08:19
@erlend-aasland erlend-aasland disabled auto-merge June 22, 2023 08:19
@erlend-aasland erlend-aasland enabled auto-merge (squash) June 22, 2023 08:23
@erlend-aasland erlend-aasland merged commit 81a926b into python:main Apr 18, 2024
32 of 33 checks passed
@miss-islington-app
Copy link

Thanks @shreyanavigyan for the PR, and @erlend-aasland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.11, 3.12.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Apr 18, 2024
…pes' [w]string_at() (pythonGH-25384)

The implementation uses 'ptr' for the name of the first parameter of
ctypes.string_at() and ctypes.wstring_at(). Align docs and docstrings
with the naming used in the implementation.

(cherry picked from commit 81a926b)

Co-authored-by: Shreyan Avigyan <[email protected]>
Co-authored-by: Irit Katriel <[email protected]>
Co-authored-by: Erlend E. Aasland <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented Apr 18, 2024

GH-118046 is a backport of this pull request to the 3.12 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.12 only security fixes label Apr 18, 2024
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Apr 18, 2024
…pes' [w]string_at() (pythonGH-25384)

The implementation uses 'ptr' for the name of the first parameter of
ctypes.string_at() and ctypes.wstring_at(). Align docs and docstrings
with the naming used in the implementation.

(cherry picked from commit 81a926b)

Co-authored-by: Shreyan Avigyan <[email protected]>
Co-authored-by: Irit Katriel <[email protected]>
Co-authored-by: Erlend E. Aasland <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented Apr 18, 2024

GH-118047 is a backport of this pull request to the 3.11 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.11 only security fixes label Apr 18, 2024
encukou pushed a commit that referenced this pull request Apr 19, 2024
…ypes' [w]string_at() (GH-25384) (GH-118046)

gh-87969: Align docs and docstrings with implementation for ctypes' [w]string_at() (GH-25384)

The implementation uses 'ptr' for the name of the first parameter of
ctypes.string_at() and ctypes.wstring_at(). Align docs and docstrings
with the naming used in the implementation.

(cherry picked from commit 81a926b)

Co-authored-by: Shreyan Avigyan <[email protected]>
Co-authored-by: Irit Katriel <[email protected]>
Co-authored-by: Erlend E. Aasland <[email protected]>
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.

9 participants