gh-110936: Improve string literal definition in Lexical Analysis

[StanFromIreland]

• Issue: Lexical analysis - Section 2.5.3 - Best order for implementation and avoid errors #110936

---

📚 Documentation preview 📚: https://cpython-previews--138063.org.readthedocs.build/

[AA-Turner]

cc @encukou, we've just reworded this section.

Perhaps this PR should be deferred in favour of the eventual goal of automatically generating the grammar snippets in the documentation for the actual grammar?

A

[StanFromIreland]

After all of the work put in to improve the snippets, I think it would be worse as the actual grammar would be much less reader friendly.

Furthermore, for this specific case the parsing is done by string_parser.c (IIRC the name) and is not explicitly defined in the grammar.

[encukou]

Pablo's comment from the issue -- “The change is not incorrect and is technically a bit more precise on the order” -- applies to this one as well.
It's a small improvement, but let's still merge it.

[StanFromIreland]

Per comment on issue.

[miss-islington-app]

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

[bedevere-app]

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