Skip to content

gh-135676: Reword the Operators & Delimiters section(s) - #137713

Merged
encukou merged 9 commits into
python:mainfrom
encukou:lex-analysis-operators
Sep 3, 2025
Merged

gh-135676: Reword the Operators & Delimiters section(s)#137713
encukou merged 9 commits into
python:mainfrom
encukou:lex-analysis-operators

Conversation

@encukou

@encukouencukou commented Aug 13, 2025•
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Member

Lexically, there is no difference between operators and delimiters, so I combined the section.

This section also serves as a kind of guide for what all the ASCII "symbol" characters do, with notes like “The period can also occur in floating-point and imaginary literals” and “The following printing ASCII characters are not used in Python”.
I've expanded the notes to include @, {, etc., but (for now) stopped short of adding a table of ASCII characters with links to where they appear.

The tables of symbols are reorganized slightly.
. was added to operators (like @, it can be either operator or delimiter).
-> was moved from augmented assignment to delimiters.

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

encukouand others added 4 commits August 13, 2025 16:38
@encukou@blaisep@AA-Turner
Initial rewording; add table of ASCII source characters
01bed13
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
@encukou
Remove the Summary of source characters
5efbd33
@encukou
More rewording
df5a1d2
@encukou
Add notes about where else symbols appear
9a23017
@bedevere-appbedevere-appBot added awaiting core review docs Documentation in the Doc dir skip news labels Aug 13, 2025
@bedevere-appbedevere-appBot mentioned this pull request Aug 13, 2025
Open
@encukouencukou added the needs backport to 3.14 bugs and security fixes label Aug 13, 2025
AA-Turner
AA-Turner reviewed Aug 13, 2025
View reviewed changes
Comment threadDoc/reference/lexical_analysis.rst Outdated
Comment threadDoc/reference/lexical_analysis.rst Outdated
Comment threadDoc/reference/lexical_analysis.rst Outdated
Comment threadDoc/reference/lexical_analysis.rst Outdated
@StanFromIrelandStanFromIreland mentioned this pull request Aug 17, 2025
Closed
@StanFromIrelandStanFromIreland linked an issue Aug 17, 2025 that may be closed by this pull request
An operator is missing in the list of tokens #99000
Closed
@encukou
encukou marked this pull request as draft August 20, 2025 16:06
@encukou

encukou commented Aug 20, 2025

Copy link
Copy Markdown
MemberAuthor

So, I looked at this and #99000 again, and found a better (IMO) way to present the information. What do you think?

What this PR is missing now is information from some existing notes:

  • The period can also occur in floating-point and imaginary literals.
  • ' " # \ have special meaning [...]
  • $ ? ` are not used in Python

I'll try adding a section for that next week.

@encukou
encukou marked this pull request as ready for review August 27, 2025 15:40
AA-Turner
AA-Turner approved these changes Sep 3, 2025
View reviewed changes
Comment threadDoc/reference/lexical_analysis.rst
AA-Turner
AA-Turner reviewed Sep 3, 2025
View reviewed changes
Comment threadDoc/reference/lexical_analysis.rst Outdated
Comment on lines +1374 to +1381
| arithmetic_operator
| bitwise_operator
| comparison_operator
| enclosing_delimiter
| other_delimiter
| assignment_operator
| other_op
| "..."

@AA-TurnerAA-TurnerSep 3, 2025

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Should e.g. assignment op be higher? += is a longer string than +.

AA-Turner
AA-Turner reviewed Sep 3, 2025
View reviewed changes
Comment threadDoc/reference/lexical_analysis.rst Outdated
@encukou@AA-Turner
Update Doc/reference/lexical_analysis.rst
59019bb
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
@encukou
encukou enabled auto-merge (squash) September 3, 2025 15:19
@encukou
encukou merged commit cfcfbdd into python:mainSep 3, 2025
27 checks passed
@github-project-automationgithub-project-automationBot moved this from Todo to Done in Docs PRsSep 3, 2025
@miss-islington-app

miss-islington-appBot commented Sep 3, 2025

Copy link
Copy Markdown

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

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Sep 3, 2025
@encukou@blaisep
@AA-Turner@miss-islington
pythongh-135676: Reword the Operators & Delimiters section(s) (python…
600819d
…GH-137713)
(cherry picked from commit cfcfbdd)
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
@bedevere-app

bedevere-appBot commented Sep 3, 2025

Copy link
Copy Markdown

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

@bedevere-appbedevere-appBot removed the needs backport to 3.14 bugs and security fixes label Sep 3, 2025
@encukou
encukou deleted the lex-analysis-operators branch September 5, 2025 15:25
lkollar pushed a commit to lkollar/cpython that referenced this pull request Sep 9, 2025
@encukou@blaisep
@AA-Turner@lkollar
pythongh-135676: Reword the Operators & Delimiters section(s) (python…
12ea33f
…GH-137713)
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
hugovk pushed a commit that referenced this pull request Sep 11, 2025
@miss-islington@encukou
@blaisep@AA-Turner
[3.14]gh-135676: Reword the Operators & Delimiters section(s) (GH-13…
15ca9c6
…7713) (#138457)
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@AA-TurnerAA-TurnerAA-Turner approved these changes
@willingcwillingcAwaiting requested review from willingcwillingc is a code owner

Assignees

No one assigned

Labels

docsDocumentation in the Doc dirskip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

An operator is missing in the list of tokens

2 participants

@encukou@AA-Turner