cpython/Doc/reference
Miss Islington (bot) bbd11568a7
[3.14] gh-143054: Disallow non-top-level Cut for now (GH-143622) (GH-143790)
The behaviour of Cut in nested parentheses, Repeat, Opt, and similar
is somewhat chaotic. Apparently even the academic papers on PEG aren't
as clear as they could be.

And it doesn't really matter. Python only uses top-level cuts.
When that changes, we can clarify as much as necessary (and even
change the implementation to make sense for what we'll need).

Document that this is deliberately unspecified, and add a test to
make sure any decision is deliberate, tested and documented.
(cherry picked from commit f0a0467c17)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-01-15 13:52:39 +01:00
..
compound_stmts.rst [3.14] Add missing comma to tuple in except* docs (GH-142395) (#142685) 2025-12-13 22:57:29 +00:00
datamodel.rst [3.14] gh-101100: Fix references to the set methods (GH-141857) (GH-142300) 2025-12-05 16:33:35 +02:00
executionmodel.rst [3.14] gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945) (#139509) 2025-10-07 19:19:42 +01:00
expressions.rst [3.14] gh-135676: Reword the f-string (and t-string) section (GH-137469) (GH-142227) 2025-12-04 11:53:12 +01:00
grammar.rst [3.14] gh-143054: Disallow non-top-level Cut for now (GH-143622) (GH-143790) 2026-01-15 13:52:39 +01:00
import.rst [3.14] gh-69686: Remove untrue part of __import__ replacement docs (GH-143261) (#143281) 2025-12-30 05:22:38 +00:00
index.rst Merge from 3.2: remove unneeded "Release" and "Date" markers from index pages. 2012-10-28 11:10:24 -07:00
introduction.rst [3.14] gh-135676: Lexical analysis: Reword String literals and related sections (GH-135942) (#137048) 2025-07-23 19:23:25 +03:00
lexical_analysis.rst [3.14] typo fixes in docs (GH-142683) (#142839) 2025-12-17 21:41:54 +05:30
simple_stmts.rst [3.14] gh-137376: Add note on top-level global declarations (GH-137707) (GH-138023) 2025-10-07 19:59:29 +02:00
toplevel_components.rst gh-130587: Add hand-written docs for non-OP tokens (GH-130588) 2025-03-19 16:42:11 +01:00