Skip to content
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

Jump to bottom

Edit What's New for Python 3.11 #95913

Open
30 of 33 tasks
CAM-Gerlach opened this issue Aug 12, 2022 · 9 comments
Open
30 of 33 tasks

Edit What's New for Python 3.11 #95913

CAM-Gerlach opened this issue Aug 12, 2022 · 9 comments
Assignees
@pablogsal @CAM-Gerlach
Labels
3.11 docs Documentation in the Doc dir

Comments

@CAM-Gerlach
Copy link
Member

CAM-Gerlach commented Aug 12, 2022 •
edited

As discussed with @pablogsal , this is a meta-issue for coordinating an editing pass on the What's New in Python 3.11 document.

The focus with this issue and its accompanying PRs will be on textual and reST/Sphinx fixes and improvements to the existing content, rather than adding any missing NEWS entries, or touching the organization of the document itself. Another issue, #95914 , will cover adding the PEPs not currently listed to the Summary - Release highlights section, as well as a few PEPs that are not documented at all in What's New, but probably should be somewhere (PEP-624, PEP-654 and PEP-670).

It seems best to split this into separate PRs, one for each top-level section. I've listed them here for reference, with PRs linked as they are submitted:

Prerequisites/General Changes

Edit Sections

Add new APIs

Adapted and updated from @pablogsal 's post

Related
@CAM-Gerlach CAM-Gerlach added docs Documentation in the Doc dir 3.11 labels Aug 12, 2022
@CAM-Gerlach CAM-Gerlach self-assigned this Aug 12, 2022
This was referenced Aug 12, 2022
Closed
Merged
@pablogsal
Copy link
Member

pablogsal commented Aug 13, 2022 •
edited by gvanrossum

The following functions has been added in 3.11 and must be (maybe) documented as well:

  • module: zipfile
    added: ['Path.suffix', 'Path.stem', 'Path.suffixes', 'ZipFile.mkdir']
  • module: tempfile
    added: ['SpooledTemporaryFile.detach', 'SpooledTemporaryFile.read1', 'SpooledTemporaryFile.writable', 'SpooledTemporaryFile.readinto1', 'SpooledTemporaryFile.seekable', 'SpooledTemporaryFile.readable', 'SpooledTemporaryFile.readinto']
  • module: hashlib
    added: ['file_digest']
  • module: traceback
    added: ['TracebackException.print', 'StackSummary.format_frame_summary']
  • module: pdb
    added: ['ScriptTarget', 'ModuleTarget']
  • module: inspect
    added: ['FrameInfo']
  • module: contextlib
    added: ['chdir']
  • module: string
    added: ['Template.is_valid', 'Template.get_identifiers']
  • module: enum
    added: ['global_enum_repr', 'global_str', 'show_flag_values', 'global_flag_repr']
  • module: asyncio.tasks
    added: ['Task.cancelling', 'Task.uncancel']
  • module: asyncio.selector_events
    added: ['BaseSelectorEventLoop.sock_recvfrom_into', 'BaseSelectorEventLoop.sock_recvfrom', 'BaseSelectorEventLoop.sock_sendto']
  • module: asyncio.proactor_events
    added: ['BaseProactorEventLoop.sock_recvfrom_into', 'BaseProactorEventLoop.sock_recvfrom', 'BaseProactorEventLoop.sock_sendto']
  • module: asyncio.sslproto
    added: ['SSLProtocolState', 'AppProtocolState', 'add_flowcontrol_defaults', 'SSLProtocol.get_buffer', 'SSLProtocol.buffer_updated']
  • module: asyncio.runners
    added: ['Runner']
  • module: asyncio.exceptions
    added: ['BrokenBarrierError']
  • module: asyncio.windows_events
    added: ['IocpProactor.recvfrom_into']
  • module: logging.handlers
    added: ['SysLogHandler.createSocket']

@pablogsal
Copy link
Member

pablogsal commented Aug 13, 2022 •
edited

CC: @tiran @iritkatriel @asvetlov @ambv as you were involved in some of the changes (and the dev in residence for awareness).

@tiran
Copy link
Member

tiran commented Aug 13, 2022

hashlib.file_digest is covered by gh-95965.

@iritkatriel
Copy link
Member

iritkatriel commented Aug 14, 2022

@jaraco should pdb.ScriptTarget pdb.ModuleTarget be documented? I think they were intended to be implementation details.

@jaraco
Copy link
Member

jaraco commented Aug 14, 2022

@jaraco should pdb.ScriptTarget pdb.ModuleTarget be documented? I think they were intended to be implementation details.

Correct. Those are implementation details.

@bedevere-bot bedevere-bot mentioned this issue Aug 15, 2022
Merged
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Aug 17, 2022
@iritkatriel
pythongh-95913: make the new internal classes pdb.ModuleTarget/Script…
eb91e0b 
…Target private
@bedevere-bot bedevere-bot mentioned this issue Aug 17, 2022
Merged
@CAM-Gerlach CAM-Gerlach changed the title Copyedit/Proofread What's New for Python 3.11 Edit What's New for Python 3.11 Aug 17, 2022
@bedevere-bot bedevere-bot mentioned this issue Aug 18, 2022
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Aug 18, 2022
@iritkatriel @miss-islington
pythongh-95913: make the new internal classes pdb.ModuleTarget/Script…
117c7c6 
…Target private (pythonGH-96053)

(cherry picked from commit 1a720c6)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
iritkatriel added a commit that referenced this issue Aug 18, 2022
@iritkatriel
gh-95913: make the new internal classes pdb.ModuleTarget/ScriptTarget…
1a720c6 
… private (GH-96053)
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Aug 18, 2022
@iritkatriel @miss-islington
pythongh-95913: Add traceback module additions to what's new in 3.11 (p…
0015245 
…ythonGH-95980)

(cherry picked from commit c5bc67b)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
iritkatriel added a commit that referenced this issue Aug 18, 2022
@iritkatriel
gh-95913: Add traceback module additions to what's new in 3.11 (GH-95980
c5bc67b 
)
@bedevere-bot bedevere-bot mentioned this issue Aug 18, 2022
Merged
iritkatriel added a commit that referenced this issue Aug 18, 2022
@miss-islington @iritkatriel
gh-95913: Add traceback module additions to what's new in 3.11 (GH-95980
7c334a3 
) (GH-96064)

(cherry picked from commit c5bc67b)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
pablogsal pushed a commit that referenced this issue Aug 18, 2022
@miss-islington @iritkatriel
[3.11] gh-95913: make the new internal classes pdb.ModuleTarget/Scrip…
1b9b485 
…tTarget private (GH-96053) (#96063)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
@CAM-Gerlach CAM-Gerlach mentioned this issue Aug 19, 2022
Merged
tiran pushed a commit to tiran/cpython that referenced this issue Aug 19, 2022
@iritkatriel @tiran
pythongh-95913: make the new internal classes pdb.ModuleTarget/Script…
eae213f 
…Target private (pythonGH-96053)
tiran pushed a commit to tiran/cpython that referenced this issue Aug 19, 2022
@iritkatriel @tiran
pythongh-95913: Add traceback module additions to what's new in 3.11 (p…
4fe1cf8 
…ythonGH-95980)
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Sep 19, 2022
@CAM-Gerlach @miss-islington
pythongh-95913: Fix and copyedit New Features section of 3.11 What's …
91446f3 
…New (pythonGH-95915)

(cherry picked from commit 8ee27e3)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
@bedevere-bot bedevere-bot mentioned this issue Sep 19, 2022
Merged
encukou pushed a commit that referenced this issue Sep 19, 2022
@CAM-Gerlach
gh-95913: Fix and copyedit New Features section of 3.11 What's New (G…
8ee27e3 
…H-95915)
encukou pushed a commit that referenced this issue Sep 19, 2022
@CAM-Gerlach @ezio-melotti @AlexWaygood
gh-95913: Copyedit, link & format Typing Features section in 3.11 Wha…
558768f 
…t's New (GH-96097)


Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
JelleZijlstra pushed a commit that referenced this issue Oct 24, 2022
@CAM-Gerlach
gh-95913: Edit & expand Deprecated section of 3.11 WhatsNew (#98581)
dfb5d27 
* Refine Sphinx syntax and grammar/phrasing in Deprecated section items
* Organize into lang/builtins, modules & stdlib sections
* Convert PEP 594 module list into a grid to not waste as much space
* Add importlib.resources deprecated functions to section
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Oct 24, 2022
@CAM-Gerlach @miss-islington
pythongh-95913: Edit & expand Deprecated section of 3.11 WhatsNew (py…
c7a6760 
…thonGH-98581)

* Refine Sphinx syntax and grammar/phrasing in Deprecated section items
* Organize into lang/builtins, modules & stdlib sections
* Convert PEP 594 module list into a grid to not waste as much space
* Add importlib.resources deprecated functions to section
(cherry picked from commit dfb5d27)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
@bedevere-bot bedevere-bot mentioned this issue Oct 24, 2022
Merged
miss-islington added a commit that referenced this issue Oct 24, 2022
@miss-islington @CAM-Gerlach
gh-95913: Edit, expand & format Bytecode sect in 3.11 WhatsNew (GH-98559
2a346b0 
)

(cherry picked from commit 22739a0)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
JelleZijlstra pushed a commit that referenced this issue Oct 24, 2022
@CAM-Gerlach
gh-95913: Add io support for SpooledTemporaryFile in 3.11 Whatsnew (#…
f3f8b6f 
…98312)
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Oct 24, 2022
@CAM-Gerlach @miss-islington
pythongh-95913: Add io support for SpooledTemporaryFile in 3.11 Whats…
f2a9bfe 
…new (pythonGH-98312)

(cherry picked from commit f3f8b6f)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
@bedevere-bot bedevere-bot mentioned this issue Oct 24, 2022
Merged
miss-islington added a commit that referenced this issue Oct 24, 2022
@miss-islington @CAM-Gerlach
gh-95913: Edit & expand Deprecated section of 3.11 WhatsNew (GH-98581)
3aed2ac 
* Refine Sphinx syntax and grammar/phrasing in Deprecated section items
* Organize into lang/builtins, modules & stdlib sections
* Convert PEP 594 module list into a grid to not waste as much space
* Add importlib.resources deprecated functions to section
(cherry picked from commit dfb5d27)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
miss-islington added a commit that referenced this issue Oct 24, 2022
@miss-islington @CAM-Gerlach
gh-95913: Add io support for SpooledTemporaryFile in 3.11 Whatsnew (G…
c4ad3fc 
…H-98312)

(cherry picked from commit f3f8b6f)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
encukou added a commit that referenced this issue Oct 24, 2022
@CAM-Gerlach @JelleZijlstra @encukou
gh-95913: Fix, sort & expand pending removal sect in 3.11 WhatsNew (G…
e19c2b9 
…H-98583)

* Fix names/references of pending removal APIs

* Sort list of APIs pending removal alphabetically

* Add missing modules/submodules pending removal in 3.12

* Add table of unittest deprecated aliases to 3.11 What's New

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Oct 24, 2022
@CAM-Gerlach @miss-islington
pythongh-95913: Fix, sort & expand pending removal sect in 3.11 Whats…
6ecd75e 
…New (pythonGH-98583)

* Fix names/references of pending removal APIs

* Sort list of APIs pending removal alphabetically

* Add missing modules/submodules pending removal in 3.12

* Add table of unittest deprecated aliases to 3.11 What's New

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
(cherry picked from commit e19c2b9)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
@bedevere-bot bedevere-bot mentioned this issue Oct 24, 2022
Merged
pablogsal pushed a commit that referenced this issue Oct 24, 2022
@miss-islington @CAM-Gerlach @pablogsal
gh-95913 Add string section to Whatsnew with new Template methods (GH…
c2cb04e 
…-98311)

(cherry picked from commit e2dc223)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
pablogsal pushed a commit that referenced this issue Oct 24, 2022
@miss-islington @CAM-Gerlach @pablogsal
gh-95913: Edit, xref & sort 3.11 WhatsNew Removed section (GH-98584)
7cdea80 
(cherry picked from commit 8dbec4d)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
pablogsal pushed a commit that referenced this issue Oct 24, 2022
@miss-islington @CAM-Gerlach @pablogsal
gh-95913: Edit, sort & expand 3.11 WhatsNew Porting section (GH-98585)
cde4cf9 
(cherry picked from commit 43bef54)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
pablogsal pushed a commit that referenced this issue Oct 24, 2022
@miss-islington @CAM-Gerlach @pablogsal
gh-95913: Edit, link and sort 3.11 WhatsNew Build section (GH-98588)
c184c67 
(cherry picked from commit e81fad6)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
JelleZijlstra added a commit that referenced this issue Oct 24, 2022
@JelleZijlstra
gh-95913: Fix grammar for SpooledTemporaryFile 3.11 whatsnew entry
de64f32 
Followup from #98312.
@bedevere-bot bedevere-bot mentioned this issue Oct 24, 2022
Merged
JelleZijlstra added a commit that referenced this issue Oct 24, 2022
@JelleZijlstra
gh-95913: Fix grammar for SpooledTemporaryFile 3.11 whatsnew entry (#…
c5a9d3f 
…98604)

Followup from #98312.
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Oct 24, 2022
@JelleZijlstra @miss-islington
pythongh-95913: Fix grammar for SpooledTemporaryFile 3.11 whatsnew en…
6c9307c 
…try (pythonGH-98604)

Followup from pythonGH-98312.
(cherry picked from commit c5a9d3f)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
@bedevere-bot bedevere-bot mentioned this issue Oct 24, 2022
Merged
miss-islington added a commit that referenced this issue Oct 24, 2022
@miss-islington @JelleZijlstra
gh-95913: Fix grammar for SpooledTemporaryFile 3.11 whatsnew entry (G…
3f6cfc5 
…H-98604)

Followup from GH-98312.
(cherry picked from commit c5a9d3f)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
This was referenced Oct 24, 2022
Closed
Merged
JelleZijlstra pushed a commit that referenced this issue Oct 25, 2022
@CAM-Gerlach
gh-95913: Prepare Improved Modules in 3.11 WhatsNew for final edits (#…
dd13b23 
…98631)

* Add two line breaks and ref target labels to remaining subsections

* Fix a few out of order Improved Modules

* Fix a few minor textual formatting issues in sections

* Fix remaining Sphinx warnings in the Improved Modules section
@bedevere-bot bedevere-bot mentioned this issue Oct 25, 2022
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Oct 25, 2022
@CAM-Gerlach @miss-islington
pythongh-95913: Prepare Improved Modules in 3.11 WhatsNew for final e…
865b150 
…dits (pythonGH-98631)

* Add two line breaks and ref target labels to remaining subsections

* Fix a few out of order Improved Modules

* Fix a few minor textual formatting issues in sections

* Fix remaining Sphinx warnings in the Improved Modules section
(cherry picked from commit dd13b23)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
miss-islington added a commit that referenced this issue Oct 25, 2022
@miss-islington @CAM-Gerlach
gh-95913: Prepare Improved Modules in 3.11 WhatsNew for final edits (G…
c96c763 
…H-98631)

* Add two line breaks and ref target labels to remaining subsections

* Fix a few out of order Improved Modules

* Fix a few minor textual formatting issues in sections

* Fix remaining Sphinx warnings in the Improved Modules section
(cherry picked from commit dd13b23)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
miss-islington added a commit that referenced this issue Oct 25, 2022
@miss-islington @CAM-Gerlach
gh-95913: Fix, sort & expand pending removal sect in 3.11 WhatsNew (G…
08c3c91 
…H-98583)

* Fix names/references of pending removal APIs

* Sort list of APIs pending removal alphabetically

* Add missing modules/submodules pending removal in 3.12

* Add table of unittest deprecated aliases to 3.11 What's New

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
(cherry picked from commit e19c2b9)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
@CAM-Gerlach CAM-Gerlach mentioned this issue Oct 27, 2022
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@pablogsal pablogsal

@CAM-Gerlach CAM-Gerlach

Labels
3.11 docs Documentation in the Doc dir
Projects
Sprint 2022
Status: In Progress
Milestone
No milestone
Development

No branches or pull requests
7 participants
@jaraco @tiran @iritkatriel @gvanrossum @pablogsal @CAM-Gerlach @kumaraditya303