Skip to content

gh-156614: Fix function parameter grammar in documentation - #156622

Open
challenge456 wants to merge 2 commits into
python:mainfrom
challenge456:fix-156614-function-parameter-grammar
Open

gh-156614: Fix function parameter grammar in documentation#156622
challenge456 wants to merge 2 commits into
python:mainfrom
challenge456:fix-156614-function-parameter-grammar

Conversation

@challenge456

Copy link
Copy Markdown

gh-156614: Fix function parameter grammar in documentation

The language reference incorrectly documents the parameter following a
bare * as optional in parameter_list_starargs.

This change makes star_parameter required in the documentation grammar
to match the actual CPython grammar and parser behavior.

The generated Lib/pydoc_data/topics.py file has also been updated.

Tests:

  • PCbuild\amd64\python.exe -m test test_syntax
  • 107 tests passed

@python-cla-bot

python-cla-bot Bot commented Aug 30, 2026

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.

CLA signed

@bedevere-app

bedevere-app Bot commented Aug 30, 2026

Copy link
Copy Markdown

Most changes to Python require a NEWS entry. Add one using the blurb_it web app or the blurb command-line tool.

If this change has little impact on Python users, wait for a maintainer to apply the skip news label instead.

@read-the-docs-community

read-the-docs-community Bot commented Aug 30, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #34296252 | 📁 Comparing d4b5be0 against main (f81c03a)

  🔍 Preview build  

2 files changed
± reference/compound_stmts.html
± whatsnew/changelog.html

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant