-
-
Notifications
You must be signed in to change notification settings - Fork 32.3k
gh-90241: Clarify documentation for PyUnicode_FSConverter and PyUnicode_FSDecoder #128451
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
Conversation
…yUnicode_FSDecoder
LGTM, but see my comment on the issue. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just a few small typos
conversion function: | ||
|
||
.. c:function:: int PyUnicode_FSConverter(PyObject* obj, void* result) | ||
|
||
ParseTuple converter: encode :class:`str` objects -- obtained directly or | ||
:ref:`PyArg_Parse\* converter <arg-parsing>`: encode :class:`str` objects -- obtained directly or |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:ref:`PyArg_Parse\* converter <arg-parsing>`: encode :class:`str` objects -- obtained directly or | |
:ref:`PyArg_Parse\* converter <arg-parsing>`: encodes :class:`str` objects -- obtained directly or |
Small typo
They are not typos. |
Co-authored-by: Stan Ulbrych <[email protected]>
- PyArg_Parse converter encode str objects
+ PyArg_Parse converter encodes str objects Since |
This is not related. Imperative style is more preferable. See documentations for other functions. For example, |
@encukou, please take a look again. Is it look good enough now? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Minor nit; otherwise looks good.
Co-authored-by: Erlend E. Aasland <[email protected]>
Thanks @serhiy-storchaka for the PR, and @encukou for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12, 3.13. |
…yUnicode_FSDecoder (pythonGH-128451) (cherry picked from commit 657d7b7) Co-authored-by: Serhiy Storchaka <[email protected]> Co-authored-by: Stan Ulbrych <[email protected]> Co-authored-by: Erlend E. Aasland <[email protected]>
…yUnicode_FSDecoder (pythonGH-128451) (cherry picked from commit 657d7b7) Co-authored-by: Serhiy Storchaka <[email protected]> Co-authored-by: Stan Ulbrych <[email protected]> Co-authored-by: Erlend E. Aasland <[email protected]>
GH-128542 is a backport of this pull request to the 3.13 branch. |
GH-128543 is a backport of this pull request to the 3.12 branch. |
…PyUnicode_FSDecoder (GH-128451) (GH-128542) (cherry picked from commit 657d7b7) Co-authored-by: Serhiy Storchaka <[email protected]> Co-authored-by: Stan Ulbrych <[email protected]> Co-authored-by: Erlend E. Aasland <[email protected]>
…PyUnicode_FSDecoder (GH-128451) (GH-128543) (cherry picked from commit 657d7b7) Co-authored-by: Serhiy Storchaka <[email protected]> Co-authored-by: Stan Ulbrych <[email protected]> Co-authored-by: Erlend E. Aasland <[email protected]>
…yUnicode_FSDecoder (pythonGH-128451) Co-authored-by: Stan Ulbrych <[email protected]> Co-authored-by: Erlend E. Aasland <[email protected]>
📚 Documentation preview 📚: https://cpython-previews--128451.org.readthedocs.build/