From 91523822455ad15340a9de6d7d801c78fad41959 Mon Sep 17 00:00:00 2001 From: Greg Stein Date: Wed, 26 Jun 2024 22:25:06 -0500 Subject: [PATCH 1/3] Small clarity change for except* In the except* discussion, four keywords are linked in a row: try, break, continue, and return. Visually, it is easy to miss the period after the "try". Adding a couple words (and the capitalization) after the period helps the reader notice the separate concerns of the keywords. --- Doc/reference/compound_stmts.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index 8181b9759517f6..95d9f68b744aab 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -383,6 +383,7 @@ have ambiguous semantics. It is not possible to mix :keyword:`except` and :keyword:`!except*` in the same :keyword:`try`. +The statements :keyword:`break`, :keyword:`continue` and :keyword:`return` cannot appear in an :keyword:`!except*` clause. From 63c45774e34b1ad89efdaf1d0eedf18fec5a3d87 Mon Sep 17 00:00:00 2001 From: Greg Stein Date: Thu, 31 Jul 2025 15:01:29 -0500 Subject: [PATCH 2/3] Combine lines. I originally inserted two words for minimal change. The suggestion reads much better. Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- Doc/reference/compound_stmts.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index 95d9f68b744aab..903d0dc924c84a 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -384,7 +384,7 @@ have ambiguous semantics. It is not possible to mix :keyword:`except` and :keyword:`!except*` in the same :keyword:`try`. The statements -:keyword:`break`, :keyword:`continue` and :keyword:`return` +The :keyword:`break`, :keyword:`continue`, and :keyword:`return` statements cannot appear in an :keyword:`!except*` clause. From f261ef5897f8ce3a9a24d84cb0a8b4865e5d7883 Mon Sep 17 00:00:00 2001 From: Greg Stein Date: Thu, 31 Jul 2025 15:01:46 -0500 Subject: [PATCH 3/3] Combine lines, part 2. Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- Doc/reference/compound_stmts.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index 903d0dc924c84a..6e5a4420829764 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -383,7 +383,6 @@ have ambiguous semantics. It is not possible to mix :keyword:`except` and :keyword:`!except*` in the same :keyword:`try`. -The statements The :keyword:`break`, :keyword:`continue`, and :keyword:`return` statements cannot appear in an :keyword:`!except*` clause.