Skip to content

gh-135676: Simplify docs on lexing names #140464

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
encukou merged 8 commits into from
Nov 26, 2025
Merged

gh-135676: Simplify docs on lexing names #140464

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
4606120
Simplify Names section
encukou Oct 8, 2025
6163c24
Casing; 3 dots for character ranges
encukou Oct 22, 2025
de6d1af
Clean-ups
encukou Oct 22, 2025
152e7aa
Mention Unicode's *ID_Start* and *ID_Continue*
encukou Oct 22, 2025
fce5e98
Make it clear that `nᵘₘᵇₑʳ` normalizes to `number`
encukou Oct 29, 2025
b9fdcf0
WIP
encukou Nov 12, 2025
2e7f7c0
Merge in the main branch
encukou Nov 19, 2025
43f6091
Reword to use XID_Start and XID_Continue
encukou Nov 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Make it clear that nᵘₘᵇₑʳ normalizes to number
  • Loading branch information
@encukou
encukou committed Oct 29, 2025
commit fce5e98384e660ad78659d00660fc2d4e96ce50a
3 changes: 2 additions & 1 deletion Doc/reference/lexical_analysis.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -522,7 +522,8 @@ as detailed in this section.

All names are converted into the `normalization form`_ NFKC while parsing.
This means that, for example, some typographic variants of characters are
converted to their "basic" form, for example::
converted to their "basic" form. For example, ``nᵘₘᵇₑʳ`` normalizes to
``number``, so Python treats them as the same name::

>>> nᵘₘᵇₑʳ = 3
Copy link
Copy Markdown
Contributor

@willingc willingc Oct 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be helpful to add an explicit comment that the normalized form of nᵘₘᵇₑʳis number.

Copy link
Copy Markdown
Member Author

@encukou encukou Oct 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this look good?

>>> number
Expand Down
Loading