Skip to content

GH-109190: Copyedit 3.12 What's New: Improve the C-API deprecations section - #109751

Merged
hugovk merged 9 commits into
python:mainfrom
AA-Turner:docs/whatsnew/c-api
Sep 25, 2023
Merged

GH-109190: Copyedit 3.12 What's New: Improve the C-API deprecations section#109751
hugovk merged 9 commits into
python:mainfrom
AA-Turner:docs/whatsnew/c-api

Conversation

@AA-Turner

@AA-TurnerAA-Turner commented Sep 22, 2023•
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Member
  • Per @vstinner's note, move deprecations of ma_version_tag and immutable types / mutable bases to the C-API section
  • Introduce Pending Removal in Python 3.14 / Python 3.15 / Future Versions sections
  • Copy the list of deprecations from 3.13 What's New to these sections (with minor copyediting)

📚 Documentation preview 📚: https://cpython-previews--109751.org.readthedocs.build/

@AA-TurnerAA-Turner added the needs backport to 3.12 only security fixes label Sep 22, 2023
@bedevere-appbedevere-appBot added awaiting review docs Documentation in the Doc dir skip news labels Sep 22, 2023
@bedevere-appbedevere-appBot mentioned this pull request Sep 22, 2023
Closed
AA-Turner
AA-Turner commented Sep 22, 2023
View reviewed changes
Comment threadDoc/whatsnew/3.12.rst
Comment on lines -1258 to -1259
* Creating :c:data:`immutable types <Py_TPFLAGS_IMMUTABLETYPE>` with mutable
bases using the C API (:gh:`95388`)

@AA-TurnerAA-TurnerSep 22, 2023

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note this entry was duplicated; I've only kept one of them

@AA-TurnerAA-Turner changed the title GH-109190: Move C-API deprecations to the C-API sectionGH-109190: Copyedit 3.12 What's New: Improve the C-API deprecations sectionSep 22, 2023
vstinner
vstinner approved these changes Sep 24, 2023
View reviewed changes

@vstinnervstinner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM.

Thanks for going through all deprecated C API! I didn't realize that this list was so long!

serhiy-storchaka
serhiy-storchaka reviewed Sep 25, 2023
View reviewed changes
Comment threadDoc/whatsnew/3.12.rst Outdated
Comment threadDoc/whatsnew/3.12.rst Outdated
Comment threadDoc/whatsnew/3.12.rst Outdated
Comment threadDoc/whatsnew/3.12.rst Outdated
Comment threadDoc/whatsnew/3.12.rst Outdated
Comment threadDoc/whatsnew/3.12.rst Outdated
@AA-Turner@serhiy-storchaka
Suggest more replacement functions
7312d08
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
serhiy-storchaka
serhiy-storchaka approved these changes Sep 25, 2023
View reviewed changes
Comment threadDoc/whatsnew/3.12.rst
* :c:func:`!PyUnicode_AsEncodedUnicode`: use c:func:`PyCodec_Encode`
* :c:func:`PyUnicode_READY`: unneeded since Python 3.12
* :c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException`
* :c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1``

@serhiy-storchakaserhiy-storchakaSep 25, 2023

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I am not sure about this. It is an internal convenient function, and it can be removed or changed in incompatible way without warning.

@AA-TurnerAA-TurnerSep 25, 2023

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

We're recommending a private replacement to a private function here, so I think it's fine. This isn't saying that readers should use the functions, just what the replacements for the deprecated versions are.

hugovk
hugovk reviewed Sep 25, 2023
View reviewed changes
Comment threadDoc/whatsnew/3.12.rst Outdated
@hugovk
hugovk enabled auto-merge (squash) September 25, 2023 12:34
@hugovk
hugovk merged commit bccc1b7 into python:mainSep 25, 2023
@miss-islington

miss-islington commented Sep 25, 2023

Copy link
Copy Markdown
Contributor

Thanks @AA-Turner for the PR, and @hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Sep 25, 2023
@AA-Turner@serhiy-storchaka@miss-islington
pythonGH-109190: Copyedit 3.12 What's New: Improve the C-API deprecat…
ee25e38
…ions section (pythonGH-109751)
(cherry picked from commit bccc1b7)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
@bedevere-app

bedevere-appBot commented Sep 25, 2023

Copy link
Copy Markdown

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

@bedevere-appbedevere-appBot removed the needs backport to 3.12 only security fixes label Sep 25, 2023
@vstinner

vstinner commented Sep 25, 2023

Copy link
Copy Markdown
Member

Would you mind to copy the "Pending Removal xxx" sections of C API Changes to What's New In Python 3.13? (main branch)

@AA-Turner

AA-Turner commented Sep 25, 2023

Copy link
Copy Markdown
MemberAuthor

Done: #109843

A

Yhg1s pushed a commit that referenced this pull request Sep 26, 2023
@miss-islington@AA-Turner@serhiy-storchaka
[3.12]GH-109190: Copyedit 3.12 What's New: Improve the C-API depreca…
a192517
…tions section (GH-109751) (#109830)
* GH-109190: Copyedit 3.12 What's New: Improve the C-API deprecations section (GH-109751)
(cherry picked from commit bccc1b7)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* Remove the weakref get object functions
---------
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
csm10495 pushed a commit to csm10495/cpython that referenced this pull request Sep 28, 2023
@AA-Turner@serhiy-storchaka@csm10495
pythonGH-109190: Copyedit 3.12 What's New: Improve the C-API deprecat…
a663082
…ions section (python#109751)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
@AA-Turner
AA-Turner deleted the docs/whatsnew/c-api branch September 29, 2023 08:16
Glyphack pushed a commit to Glyphack/cpython that referenced this pull request Sep 2, 2024
@AA-Turner@serhiy-storchaka@Glyphack
pythonGH-109190: Copyedit 3.12 What's New: Improve the C-API deprecat…
41d58be
…ions section (python#109751)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@vstinnervstinnervstinner approved these changes
@hugovkhugovkhugovk approved these changes
@serhiy-storchakaserhiy-storchakaserhiy-storchaka approved these changes
@ambvambvAwaiting requested review from ambv

Assignees

No one assigned

Labels

docsDocumentation in the Doc dirskip news

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@AA-Turner@miss-islington@vstinner@hugovk@serhiy-storchaka