cpython/Doc/reference
Petr Viktorin d842895a9d
[3.15] gh-141984: Reword docs on "enclosed" atom grammar (GH-148622) (GH-150552)
Reorganize and reword the docs on atoms in parentheses, brackets and braces:
parenthesized groups, list/set/dict/tuple displays, and comprehensions.
(Generator expressions and yield atoms are left for later.)

In the spirit of better matching the underlying grammar, *comprehensions* are
covered separately from non-comprehension displays. Also, parenthesized forms
(with a single expression) and tuple displays are separated.
All sections are rewritten to start with simple cases and build up to the full
formal grammar.



(cherry picked from commit 55f2518326)

Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-05-29 10:09:38 +02:00
..
compound_stmts.rst [3.15] gh-149861: Fix rule in match statement case_block PEG grammar (GH-149908) 2026-05-27 16:24:47 +01:00
datamodel.rst gh-134690: Removed deprecated codetype.co_lnotab (#134691) 2026-04-25 19:13:48 +03:00
executionmodel.rst gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945) 2025-10-02 09:13:22 -06:00
expressions.rst [3.15] gh-141984: Reword docs on "enclosed" atom grammar (GH-148622) (GH-150552) 2026-05-29 10:09:38 +02:00
grammar.rst gh-143054: Disallow non-top-level Cut for now (GH-143622) 2026-01-13 13:21:59 +01:00
import.rst gh-69686: Remove untrue part of __import__ replacement docs (#143261) 2025-12-29 21:16:54 -08: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 gh-135676: Lexical analysis: Reword String literals and related sections (GH-135942) 2025-07-23 15:57:54 +00:00
lexical_analysis.rst Docs: Fix a typo in the 'Non-ASCII characters in names' section (#148043) 2026-04-04 17:45:52 +01:00
simple_stmts.rst gh-137337: Clarify import statement namespace binding (GH-144607) 2026-05-04 17:45:00 +03:00
toplevel_components.rst gh-130587: Add hand-written docs for non-OP tokens (GH-130588) 2025-03-19 16:42:11 +01:00