diff options
author | Benjamin Peterson <benjamin@python.org> | 2022-09-14 07:59:23 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-09-14 07:59:23 -0700 |
commit | 9f1814723f5596115a794a8bec0d053f25dbf32f (patch) | |
tree | 04ec60d0cb294935ea1f1456b40e0967ebafd18f | |
parent | 92338f8f19dd760b566feb17422a4a4736f171b4 (diff) | |
download | cpython-git-9f1814723f5596115a794a8bec0d053f25dbf32f.tar.gz |
Revert accidental removal from 3.12 doc. (gh-96826)
-rw-r--r-- | Doc/whatsnew/3.12.rst | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst index 1d3ce88bb2..4a6b9c0ba5 100644 --- a/Doc/whatsnew/3.12.rst +++ b/Doc/whatsnew/3.12.rst @@ -1,4 +1,74 @@ +**************************** + What's New In Python 3.12 +**************************** + +:Release: |release| +:Date: |today| + +.. Rules for maintenance: + + * Anyone can add text to this document. Do not spend very much time + on the wording of your changes, because your text will probably + get rewritten to some degree. + + * The maintainer will go through Misc/NEWS periodically and add + changes; it's therefore more important to add your changes to + Misc/NEWS than to this file. + + * This is not a complete list of every single change; completeness + is the purpose of Misc/NEWS. Some changes I consider too small + or esoteric to include. If such a change is added to the text, + I'll just remove it. (This is another reason you shouldn't spend + too much time on writing your addition.) + + * If you want to draw your new text to the attention of the + maintainer, add 'XXX' to the beginning of the paragraph or + section. + + * It's OK to just add a fragmentary note about a change. For + example: "XXX Describe the transmogrify() function added to the + socket module." The maintainer will research the change and + write the necessary text. + + * You can comment out your additions if you like, but it's not + necessary (especially when a final release is some months away). + + * Credit the author of a patch or bugfix. Just the name is + sufficient; the e-mail address isn't necessary. + + * It's helpful to add the bug/patch number as a comment: + + XXX Describe the transmogrify() function added to the socket + module. + (Contributed by P.Y. Developer in :issue:`12345`.) + + This saves the maintainer the effort of going through the Mercurial log + when researching a change. + +This article explains the new features in Python 3.12, compared to 3.11. + +For full details, see the :ref:`changelog <changelog>`. + +.. note:: + + Prerelease users should be aware that this document is currently in draft + form. It will be updated substantially as Python 3.12 moves towards release, + so it's worth checking back even after reading earlier versions. + + +Summary -- Release highlights +============================= + +.. This section singles out the most important changes in Python 3.12. + Brevity is key. + + +.. PEP-sized items next. + +Important deprecations, removals or restrictions: + +* :pep:`623`, Remove wstr from Unicode New Features |