GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Link to existing rules in compound_stmts.rst by encukou · Pull Request #149811 · python/cpython

Conversation

@encukou

@encukou encukou commented May 13, 2026

Copy link
Copy Markdown
Member

In gh-138418, ! was added to links to rules that don't exist in the docs, in order to silence broken link warnings. However, productionlist doesn't parse the !, which ends up in the rendered documentation. (It's possible that gh-127835 broke the ! support.)

Replace the names with ones that appear in docs:

  • star_named_expression in the grammar corresponds to flexible_expression in the docs
  • star_named_expressions in the grammar corresponds to flexible_expression_list in the docs
  • named_expression in the grammar corresponds to assignment_expression in the docs

Having two sets of names isn't great of course. Consolidating them is tracked in (subissues of) gh-127833.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
@encukou
Link to existing rules in compound_stmts.rst
14c8cba
In pythongh-138418, `!` was added to links to rules that don't exist in
the docs, in order to silence broken link warnings.
However, productionlist doesn't parse the `!`, which ends up in
the rendered documentation. (It's possible that pythongh-127835 broke
the `!` support.)

Replace the names with ones that appear in docs:

- `star_named_expression` in the grammar corresponds to
  `flexible_expression` in the docs
- `star_named_expressions` in the grammar corresponds to
  `flexible_expression_list` in the docs
- `named_expression` in the grammar corresponds to
  `assignment_expression` in the docs

Having two sets of names isn't great of course. Consolidating them
is tracked in (subissues of) pythongh-127833.
@encukou
encukou requested a review from StanFromIreland May 13, 2026 22:54
@encukou
encukou requested review from AA-Turner and willingc as code owners May 13, 2026 22:54
@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news awaiting core review labels May 13, 2026
@github-project-automation github-project-automation Bot added this to Docs PRs May 13, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs May 13, 2026
@encukou encukou mentioned this pull request May 13, 2026
Allow breaking cross-reference of tokens in a productionlist #148845
Closed
@read-the-docs-community

read-the-docs-community Bot commented May 13, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #32681196 | 📁 Comparing 14c8cba against main (50476a7)

  🔍 Preview build  

1 file changed
± reference/compound_stmts.html
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@encukou encukou added the skip issue label May 13, 2026
StanFromIreland
StanFromIreland approved these changes May 14, 2026
View reviewed changes

@StanFromIreland StanFromIreland left a comment

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks Petr!

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
@bedevere-app bedevere-app Bot added awaiting merge and removed awaiting core review labels May 14, 2026
@encukou encukou added needs backport to 3.13 only security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 bugs and security fixes labels May 14, 2026
@encukou
encukou merged commit c375292 into python:main May 14, 2026
48 checks passed

Uh oh!

There was an error while loading. Please reload this page.

@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs May 14, 2026
@miss-islington-app

miss-islington-app Bot commented May 14, 2026

Copy link
Copy Markdown

Thanks @encukou for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@bedevere-app bedevere-app Bot removed the awaiting merge label May 14, 2026
@bedevere-app

bedevere-app Bot commented May 14, 2026

Copy link
Copy Markdown

GH-149836 is a backport of this pull request to the 3.15 branch.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 bugs and security fixes label May 14, 2026
@bedevere-app

bedevere-app Bot commented May 14, 2026

Copy link
Copy Markdown

GH-149837 is a backport of this pull request to the 3.14 branch.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label May 14, 2026
@bedevere-app

bedevere-app Bot commented May 14, 2026

Copy link
Copy Markdown

GH-149838 is a backport of this pull request to the 3.13 branch.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@bedevere-app bedevere-app Bot removed the needs backport to 3.13 only security fixes label May 14, 2026
encukou added a commit that referenced this pull request May 14, 2026
@miss-islington @encukou
[3.15] Link to existing rules in compound_stmts.rst (GH-149811) (GH-1…
451f06b
…49836)

Link to existing rules in compound_stmts.rst (GH-149811)

In gh-138418, `!` was added to links to rules that don't exist in
the docs, in order to silence broken link warnings.
However, productionlist doesn't parse the `!`, which ends up in
the rendered documentation. (It's possible that gh-127835 broke
the `!` support.)

Replace the names with ones that appear in docs:

- `star_named_expression` in the grammar corresponds to
  `flexible_expression` in the docs
- `star_named_expressions` in the grammar corresponds to
  `flexible_expression_list` in the docs
- `named_expression` in the grammar corresponds to
  `assignment_expression` in the docs

Having two sets of names isn't great of course. Consolidating them
is tracked in (subissues of) gh-127833.
(cherry picked from commit c375292)

Co-authored-by: Petr Viktorin <[email protected]>
encukou added a commit that referenced this pull request May 14, 2026
@miss-islington @encukou
[3.14] Link to existing rules in compound_stmts.rst (GH-149811) (GH-1…
9a1f30f
…49837)

Link to existing rules in compound_stmts.rst (GH-149811)

In gh-138418, `!` was added to links to rules that don't exist in
the docs, in order to silence broken link warnings.
However, productionlist doesn't parse the `!`, which ends up in
the rendered documentation. (It's possible that gh-127835 broke
the `!` support.)

Replace the names with ones that appear in docs:

- `star_named_expression` in the grammar corresponds to
  `flexible_expression` in the docs
- `star_named_expressions` in the grammar corresponds to
  `flexible_expression_list` in the docs
- `named_expression` in the grammar corresponds to
  `assignment_expression` in the docs

Having two sets of names isn't great of course. Consolidating them
is tracked in (subissues of) gh-127833.
(cherry picked from commit c375292)

Co-authored-by: Petr Viktorin <[email protected]>
encukou added a commit that referenced this pull request May 14, 2026
@miss-islington @encukou
[3.13] Link to existing rules in compound_stmts.rst (GH-149811) (GH-1…
4da3e91
…49838)

Link to existing rules in compound_stmts.rst (GH-149811)

In gh-138418, `!` was added to links to rules that don't exist in
the docs, in order to silence broken link warnings.
However, productionlist doesn't parse the `!`, which ends up in
the rendered documentation. (It's possible that gh-127835 broke
the `!` support.)

Replace the names with ones that appear in docs:

- `star_named_expression` in the grammar corresponds to
  `flexible_expression` in the docs
- `star_named_expressions` in the grammar corresponds to
  `flexible_expression_list` in the docs
- `named_expression` in the grammar corresponds to
  `assignment_expression` in the docs

Having two sets of names isn't great of course. Consolidating them
is tracked in (subissues of) gh-127833.
(cherry picked from commit c375292)

Co-authored-by: Petr Viktorin <[email protected]>
@encukou
encukou deleted the compound_stmts-rule-links branch May 14, 2026 17:34
@StanFromIreland StanFromIreland mentioned this pull request May 15, 2026
The PEG rule "case_block" of match statement seems not rendered correctly #149861
Closed
StanFromIreland
StanFromIreland reviewed May 15, 2026
View reviewed changes
Comment thread Doc/reference/compound_stmts.rst
: | `!named_expression`
subject_expr: `flexible_expression` "," [`flexible_expression_list` [',']]
: | `assignment_expression`
case_block: 'case' `patterns` [`guard`] ":" `!block`

@StanFromIreland StanFromIreland May 15, 2026

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This one was missed.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@StanFromIreland StanFromIreland StanFromIreland approved these changes
@willingc willingc Awaiting requested review from willingc willingc is a code owner
@AA-Turner AA-Turner Awaiting requested review from AA-Turner AA-Turner is a code owner

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

docs Documentation in the Doc dir skip issue skip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

2 participants

@encukou @StanFromIreland
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.