From 6fa64220482864758890ade64addadc91c963320 Mon Sep 17 00:00:00 2001 From: bswck Date: Sat, 25 Oct 2025 00:53:32 +0200 Subject: [PATCH 1/5] Recommend new REPL in the asyncio REPL docs --- Doc/library/asyncio.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst index 444db01390d922..a64830cb051d73 100644 --- a/Doc/library/asyncio.rst +++ b/Doc/library/asyncio.rst @@ -79,6 +79,10 @@ You can experiment with an ``asyncio`` concurrent context in the :term:`REPL`: >>> await asyncio.sleep(10, result='hello') 'hello' +It is highly recommended to use the asyncio REPL in +:envvar:`the Python-based REPL mode ` +for optimal experience and new features. + .. audit-event:: cpython.run_stdin "" "" .. versionchanged:: 3.12.5 (also 3.11.10, 3.10.15, 3.9.20, and 3.8.20) From d23ec143803ac0f1e76ba28df5baeb8482ebf933 Mon Sep 17 00:00:00 2001 From: bswck Date: Sat, 25 Oct 2025 01:05:27 +0200 Subject: [PATCH 2/5] Use a ref instead --- Doc/library/asyncio.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst index a64830cb051d73..e13014290c9006 100644 --- a/Doc/library/asyncio.rst +++ b/Doc/library/asyncio.rst @@ -80,7 +80,7 @@ You can experiment with an ``asyncio`` concurrent context in the :term:`REPL`: 'hello' It is highly recommended to use the asyncio REPL in -:envvar:`the Python-based REPL mode ` +:ref:`the Python-based REPL mode ` for optimal experience and new features. .. audit-event:: cpython.run_stdin "" "" From b92a533f36a5a2299ad165c9c52316b3fcd7323e Mon Sep 17 00:00:00 2001 From: bswck Date: Sat, 25 Oct 2025 01:16:35 +0200 Subject: [PATCH 3/5] Reword, use `:envvar:` role as intended --- Doc/library/asyncio.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst index e13014290c9006..7af122c2cde1eb 100644 --- a/Doc/library/asyncio.rst +++ b/Doc/library/asyncio.rst @@ -79,9 +79,9 @@ You can experiment with an ``asyncio`` concurrent context in the :term:`REPL`: >>> await asyncio.sleep(10, result='hello') 'hello' -It is highly recommended to use the asyncio REPL in -:ref:`the Python-based REPL mode ` -for optimal experience and new features. +Although the asyncio REPL provides limited compatibility with :envvar:`PYTHON_BASIC_REPL`, +using it in the default Python-based REPL mode is recommended for full functionality +and the latest features. .. audit-event:: cpython.run_stdin "" "" From b1e6830407c369f207f777cfe1f8ea3ec0b3db06 Mon Sep 17 00:00:00 2001 From: bswck Date: Sat, 25 Oct 2025 01:17:58 +0200 Subject: [PATCH 4/5] Disambiguate --- Doc/library/asyncio.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst index 7af122c2cde1eb..1063d139d696d0 100644 --- a/Doc/library/asyncio.rst +++ b/Doc/library/asyncio.rst @@ -79,9 +79,9 @@ You can experiment with an ``asyncio`` concurrent context in the :term:`REPL`: >>> await asyncio.sleep(10, result='hello') 'hello' -Although the asyncio REPL provides limited compatibility with :envvar:`PYTHON_BASIC_REPL`, -using it in the default Python-based REPL mode is recommended for full functionality -and the latest features. +This REPL provides limited compatibility with :envvar:`PYTHON_BASIC_REPL`. +It is recommended that the default Python-based REPL mode is used +for full functionality and the latest features. .. audit-event:: cpython.run_stdin "" "" From 3b94684259af78ce25c7c4ffb9d45a64b13366b9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartosz=20S=C5=82awecki?= Date: Thu, 6 Nov 2025 00:10:53 +0100 Subject: [PATCH 5/5] Reword for simplicity Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --- Doc/library/asyncio.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst index 1063d139d696d0..0f72e31dee5f1d 100644 --- a/Doc/library/asyncio.rst +++ b/Doc/library/asyncio.rst @@ -80,7 +80,7 @@ You can experiment with an ``asyncio`` concurrent context in the :term:`REPL`: 'hello' This REPL provides limited compatibility with :envvar:`PYTHON_BASIC_REPL`. -It is recommended that the default Python-based REPL mode is used +It is recommended that the default REPL is used for full functionality and the latest features. .. audit-event:: cpython.run_stdin "" ""