From: chemelnucfin <3982092+chemelnucfin@users.noreply.github.com> Date: Fri, 1 May 2026 08:11:53 +0000 (-0700) Subject: gh-133560: Clarified `parser.md` doc for pegen parser issue in using the existing... X-Git-Tag: v3.15.0b1~144 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f4f82f0ab6431837f4aca19c20fd1d25913b70c5;p=thirdparty%2FPython%2Fcpython.git gh-133560: Clarified `parser.md` doc for pegen parser issue in using the existing `Grammar/python.gram` file. (GH-139194) Co-authored-by: Petr Viktorin --- diff --git a/InternalDocs/parser.md b/InternalDocs/parser.md index 1d0ffe6d40d0..1bb4cdea5439 100644 --- a/InternalDocs/parser.md +++ b/InternalDocs/parser.md @@ -819,6 +819,13 @@ directory on the CPython repository and manually call the parser generator by ex $ python -m pegen python ``` +> [!CAUTION] +> Python's grammar (the `Grammar/python.gram` file) is written for the +> C backend. To experiment, you will need to write a grammar +> without C-specific parts like actions and the trailer. +> See [#133560](https://github.com/python/cpython/issues/133560) +> and [#96424](https://github.com/python/cpython/issues/96424) for more information. + This will generate a file called `parse.py` in the same directory that you can use to parse some input: