cpython/Doc/reference
Stan Ulbrych 79245a47ed
[3.14] gh-135676: Simplify docs on lexing names (GH-140464) (GH-142015)
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

(cherry picked from commit 2ff8608b4d)

Co-authored-by: Petr Viktorin <encukou@gmail.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-12-03 13:43:06 +01:00
..
compound_stmts.rst [3.14] gh-135629: rewrite language reference section on except* to improve clarity (GH-136150) (#139059) 2025-10-07 19:14:16 +01:00
datamodel.rst [3.14] Docs: replace an esoteric Von Neumann mention (GH-137598) (#141071) 2025-11-05 23:20:17 +02:00
executionmodel.rst [3.14] gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945) (#139509) 2025-10-07 19:19:42 +01:00
expressions.rst [3.14] gh-97914: Reword misleading sentence on conditional expressions (GH-139064) (#140093) 2025-10-14 08:28:12 +00:00
grammar.rst [3.14] gh-135676: Lexical analysis: Reword String literals and related sections (GH-135942) (#137048) 2025-07-23 19:23:25 +03: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 [3.14] gh-135676: Lexical analysis: Reword String literals and related sections (GH-135942) (#137048) 2025-07-23 19:23:25 +03:00
lexical_analysis.rst [3.14] gh-135676: Simplify docs on lexing names (GH-140464) (GH-142015) 2025-12-03 13:43:06 +01:00
simple_stmts.rst [3.14] gh-137376: Add note on top-level global declarations (GH-137707) (GH-138023) 2025-10-07 19:59:29 +02:00
toplevel_components.rst gh-130587: Add hand-written docs for non-OP tokens (GH-130588) 2025-03-19 16:42:11 +01:00