cpython/Doc/reference
Petr Viktorin 2ff8608b4d
gh-135676: Simplify docs on lexing names (GH-140464)
This simplifies the Lexical Analysis section on Names (but keeps it technically correct) by putting all the info about non-ASCII characters in a separate (and very technical) section.

It uses a mental model where the parser doesn't handle Unicode complexity “immediately”, but:

- parses any non-ASCII character (outside strings/comments) as part of a name, since these can't (yet) be e.g. operators
- normalizes the name
- validates the name, using the xid_start/xid_continue sets


Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Micha Albert <info@micha.zone>
Co-authored-by: KeithTheEE <kmurrayis@gmail.com>
2025-11-26 16:10:44 +01:00
..
compound_stmts.rst Make sure the `:keyword: role works for case` (#138878) 2025-09-21 11:49:49 +01:00
datamodel.rst gh-41779: Allow defining the __dict__ and __weakref__ __slots__ for any class (GH-141755) 2025-11-19 17:11:37 +00:00
executionmodel.rst gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945) 2025-10-02 09:13:22 -06:00
expressions.rst gh-97914: Reword misleading sentence on conditional expressions (#139064) 2025-10-14 11:21:13 +03:00
grammar.rst gh-135676: Lexical analysis: Reword String literals and related sections (GH-135942) 2025-07-23 15:57:54 +00:00
import.rst Doc: update term "namespace package" (#129251) 2025-02-14 13:47:54 -05:00
index.rst Merge from 3.2: remove unneeded "Release" and "Date" markers from index pages. 2012-10-28 11:10:24 -07:00
introduction.rst gh-135676: Lexical analysis: Reword String literals and related sections (GH-135942) 2025-07-23 15:57:54 +00:00
lexical_analysis.rst gh-135676: Simplify docs on lexing names (GH-140464) 2025-11-26 16:10:44 +01:00
simple_stmts.rst gh-138871: Clarify NameError exception in 'del' (#138881) 2025-09-15 02:11:01 -04:00
toplevel_components.rst gh-130587: Add hand-written docs for non-OP tokens (GH-130588) 2025-03-19 16:42:11 +01:00