python / python/cpython

Beschreibung

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).

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
3. Forke das Repository und arbeite in einem Branch.
4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Bewertung

Tech-Stack

python

Bereich

documentation, tooling

Issue-Typ

Bug

Schwierigkeit

4/5

Geschätzter Aufwand

3-5 Tage

Aktivitätsstatus

Veraltet

Klarheit

Muss geklärt werden

Anfängerfreundlichkeit

30/100