← 返回首页
[3.11] gh-91317: Document that Path does not collapse initial `//` (GH-32193) by miss-islington · Pull Request #93702 · python/cpython · GitHub
Skip to content

Navigation Menu

Toggle navigation
Sign in
Appearance settings
Search or jump to...

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Saved searches

Use saved searches to filter your results more quickly

Appearance settings
Resetting focus

[3.11] gh-91317: Document that Path does not collapse initial // (GH-32193)#93702

Merged
miss-islington merged 1 commit into
python:3.11from
miss-islington:backport-78f1a43-3.11
Jun 10, 2022
Merged

[3.11] gh-91317: Document that Path does not collapse initial // (GH-32193)#93702
miss-islington merged 1 commit into
python:3.11from
miss-islington:backport-78f1a43-3.11

Conversation

miss-islington commented Jun 10, 2022
edited
Loading

Copy link
Copy Markdown
Contributor

Documentation for pathlib says:

Spurious slashes and single dots are collapsed, but double dots ('..') are not, since this would change the meaning of a path in the face of symbolic links:

However, it omits that initial double slashes also aren't collapsed.

Later, in documentation of PurePath.drive, PurePath.root, and PurePath.name it mentions UNC but:

  • this abbreviation says nothing to a person who is unaware about existence of UNC (Wikipedia doesn't help either by giving a disambiguation page)
  • it shows up only if a person needs to use a specific property or decides to fully learn what the module provides.

For context, see the BPO entry.
(cherry picked from commit 78f1a43)

Co-authored-by: Oleg Iarygin oleg@arhadthedev.net

Automerge-Triggered-By: GH:brettcannon

…thonGH-32193) Documentation for `pathlib` says: > Spurious slashes and single dots are collapsed, but double dots ('..') are not, since this would change the meaning of a path in the face of symbolic links: However, it omits that initial double slashes also aren't collapsed. Later, in documentation of `PurePath.drive`, `PurePath.root`, and `PurePath.name` it mentions UNC but: - this abbreviation says nothing to a person who is unaware about existence of UNC (Wikipedia doesn't help either by [giving a disambiguation page](https://en.wikipedia.org/wiki/UNC)) - it shows up only if a person needs to use a specific property or decides to fully learn what the module provides. For context, see the BPO entry. (cherry picked from commit 78f1a43) Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>

Copy link
Copy Markdown
Contributor Author

Status check is done, and it's a success ✅ .

Copy link
Copy Markdown
Contributor Author

Status check is done, and it's a success ✅ .

miss-islington merged commit 3a202de into python:3.11 Jun 10, 2022
miss-islington deleted the backport-78f1a43-3.11 branch June 10, 2022 23:07

Copy link
Copy Markdown
Contributor Author

Status check is done, and it's a success ✅ .

This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

Footer

© 2026 GitHub, Inc.