cpython/Doc/reference
Petr Viktorin 55f2518326
gh-141984: Reword docs on "enclosed" atom grammar (GH-148622)
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.

Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-05-27 14:32:33 +02:00
..
compound_stmts.rst gh-149861: Fix rule in match statement case_block PEG grammar (GH-149908) 2026-05-27 12:25:21 +02: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 gh-141984: Reword docs on "enclosed" atom grammar (GH-148622) 2026-05-27 14:32:33 +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
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-149321: Remove lazy_imports=none startup mode (#149389) 2026-05-19 16:01:15 -07:00
toplevel_components.rst gh-130587: Add hand-written docs for non-OP tokens (GH-130588) 2025-03-19 16:42:11 +01:00