Skip to content

gh-141984: Reword and reorganize Subscription (and Slicing) docs #141985

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 23 commits into from
Feb 4, 2026
Merged

gh-141984: Reword and reorganize Subscription (and Slicing) docs #141985

Changes from 1 commit
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
7d892d3
Start on Subscriptions and slicing
encukou Sep 10, 2025
bb70707
Continue Subscriptions and slicing
encukou Sep 24, 2025
0cd76e6
Reorganize, add sections
encukou Oct 29, 2025
c8d0f9e
Continue rewording
encukou Oct 29, 2025
d3e1c13
Merge in the main branch
encukou Nov 26, 2025
e755b5d
More work here
encukou Nov 26, 2025
0aa0256
A correction and a simplification
encukou Nov 26, 2025
ec68594
Apply suggestions from code review
encukou Dec 3, 2025
3495d74
Start on glossary entries
encukou Nov 27, 2025
9e8aafb
Merge subscriptions and slicings in simple_stmts.rst
encukou Dec 3, 2025
bb3f441
Continue on glossary
encukou Dec 3, 2025
dadc1f3
Plural section names, priority table clarification
encukou Dec 3, 2025
6492007
Improve glossary entries
encukou Dec 3, 2025
26daff2
Merge in the main branch
encukou Jan 7, 2026
a9c6d8d
Apply suggestions from code review
encukou Jan 7, 2026
7b3e41d
Add a 'continuing' comment to examples that use SubscriptionDemo
encukou Jan 7, 2026
5e4d1d9
Add colon
encukou Jan 7, 2026
b489b76
Use the term "special method"
encukou Dec 3, 2025
aa56eb8
Link the new terms, *key* and *index*
encukou Jan 7, 2026
d8e22a4
Apply suggestions from code review
encukou Feb 4, 2026
692cede
Merge branch 'main' into expressions-subscription
encukou Feb 4, 2026
0d7be86
Rename rules & condense the note on ambiguity
encukou Feb 4, 2026
bbac1fc
Apply suggestions from code review
encukou Feb 4, 2026
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
Add a 'continuing' comment to examples that use SubscriptionDemo
  • Loading branch information
@encukou
encukou committed Jan 7, 2026
commit 7b3e41d3821e404446f2107b092d37efd8ba7cda
2 changes: 2 additions & 0 deletions Doc/reference/expressions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1065,6 +1065,7 @@ Any missing expression evaluates to :const:`None`.
This :class:`!slice` object is then passed to the :meth:`~object.__getitem__`
or :meth:`~object.__class_getitem__` method, as above. ::

# continuing with the SubscriptionDemo instance defined above:
>>> demo[2:3]
subscripted with: slice(2, 3, None)
>>> demo[::'spam']
Expand Down Expand Up @@ -1106,6 +1107,7 @@ The subscript can also contain a starred expression.
In this case, the interpreter unpacks the result into a tuple, and passes
this tuple to :meth:`~object.__getitem__` or :meth:`~object.__class_getitem__`::

# continuing with the SubscriptionDemo instance defined above:
>>> demo[*range(10)]
subscripted with: (0, 1, 2, 3, 4, 5, 6, 7, 8, 9)

Expand Down
Loading