Clarify docstrings of pathlib suffix(es)

[cool-RR]

BPO	38422
Nosy	@taleinat, @cool-RR, @miss-islington
PRs	bpo-38422: Clarify docstrings of pathlib suffix(es) #16679 [3.8] bpo-38422: Clarify docstrings of pathlib suffix(es) (GH-16679) #17031 [3.7] bpo-38422: Clarify docstrings of pathlib suffix(es) (GH-16679) #17032

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2019-11-02.17:05:34.461>
created_at = <Date 2019-10-09.15:15:39.205>
labels = ['3.7', '3.8', 'type-feature', 'library', '3.9']
title = 'Clarify docstrings of pathlib suffix(es)'
updated_at = <Date 2019-11-02.17:05:34.461>
user = 'https://github.com/cool-RR'

bugs.python.org fields:

activity = <Date 2019-11-02.17:05:34.461>
actor = 'pitrou'
assignee = 'none'
closed = True
closed_date = <Date 2019-11-02.17:05:34.461>
closer = 'pitrou'
components = ['Library (Lib)']
creation = <Date 2019-10-09.15:15:39.205>
creator = 'cool-RR'
dependencies = []
files = []
hgrepos = []
issue_num = 38422
keywords = ['patch']
message_count = 5.0
messages = ['354279', '354508', '355874', '355875', '355876']
nosy_count = 3.0
nosy_names = ['taleinat', 'cool-RR', 'miss-islington']
pr_nums = ['16679', '17031', '17032']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue38422'
versions = ['Python 3.7', 'Python 3.8', 'Python 3.9']

[cool-RR]

I'm writing a PR for this right now.

[taleinat]

From the PR, the rationale for this suggestion is:

"Whenever I use path.suffix I have to check again whether it includes the dot or not. I decided to add it to the docstring so I won't have to keep checking."

[miss-islington]

New changeset 8d4fef4 by Miss Skeleton (bot) (Ram Rachum) in branch 'master':
bpo-38422: Clarify docstrings of pathlib suffix(es) (GH-16679)
8d4fef4

[miss-islington]

New changeset aa1fee8 by Miss Skeleton (bot) in branch '3.8':
bpo-38422: Clarify docstrings of pathlib suffix(es) (GH-16679)
aa1fee8

[miss-islington]

New changeset 72b874a by Miss Skeleton (bot) in branch '3.7':
bpo-38422: Clarify docstrings of pathlib suffix(es) (GH-16679)
72b874a