Skip to content

gh-105286: Improve typing.py docstrings #105287

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
AlexWaygood merged 12 commits into from
Jun 5, 2023
Merged

gh-105286: Improve typing.py docstrings #105287

Changes from 1 commit
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
e808f2b
Improve `typing.py` docstrings
AlexWaygood Jun 4, 2023
7f20599
Apply suggestions from code review
AlexWaygood Jun 5, 2023
d59d72b
Update Lib/typing.py
AlexWaygood Jun 5, 2023
f96723e
Update Lib/typing.py
AlexWaygood Jun 5, 2023
9f132e9
Colons
AlexWaygood Jun 5, 2023
e7983b2
Use two colons everywhere
AlexWaygood Jun 5, 2023
ff90369
Newlines following class docstrings as per PEP 257
AlexWaygood Jun 5, 2023
d54c06b
Nit
AlexWaygood Jun 5, 2023
ab3e627
Fix first line of NoReturn docstring
AlexWaygood Jun 5, 2023
748c55f
Better first sentences
AlexWaygood Jun 5, 2023
f9e27e2
Make module docstring more user-facing
AlexWaygood Jun 5, 2023
58fbb0f
Capitalise Point2D
AlexWaygood Jun 5, 2023
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
Update Lib/typing.py
  • Loading branch information
@AlexWaygood
AlexWaygood authored Jun 5, 2023
commit f96723eab269b8ba5691ed62b3be8eb09f89b50d
4 changes: 3 additions & 1 deletion Lib/typing.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -566,7 +566,9 @@ def int_or_str(arg: int | str) -> None:

@_SpecialForm
def Self(self, parameters):
"""Used to spell the type of "self" in classes::
"""Used to spell the type of "self" in classes.

Example::

from typing import Self

Expand Down