python / python/cpython

Description

My original question has answered by Stan. I leave it here as a record:

Click to expand

I'm not sure if it's done deliberately, but it seems odd to me and I can't find out why it happens so far.

---

The reference/grammar.rst includes Grammar/python.gram

https://github.com/python/cpython/blob/78a50ee10ef73296eba98899d496bff3915ddc41/Doc/reference/grammar.rst#L18-L19

and Grammar/python.gram has a section for invalid rules at the bottom.

https://github.com/python/cpython/blob/78a50ee10ef73296eba98899d496bff3915ddc41/Grammar/python.gram#L1193-L1202

However, the content after START OF INVALID RULES is missing on the page

snapshot

I checked the previous version and found out the doc has this issue since 3.11 (after PEG parser is introduced).

---

Other info:
I translated this page into Traditional Chinese (zh-tw) recently and somehow it shows correctly on the translated page

snapshot

So here's the revised issue description:

Some elements in Grammar/python.gram are stripped by peg_lexer.py, and hence they're hidden on the reference/grammar docs. However, the full content of Grammar/python.gram is still remained in the generated PO files (e.g. the one in zh-tw).

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

1. Lisez l'issue en entier, puis le guide de contribution du projet.
2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
3. Forkez le dépôt et travaillez sur une branche.
4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Évaluation

Stack technique

python

Domaine

documentation, tooling

Type d'issue

Bug

Difficulté

4/5

Temps estimé

3-5 jours

Activité

À l'abandon

Clarté

À clarifier

Accessibilité débutants

30/100