mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-27 02:39:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 13

bpo-26329: update os.path.normpath documentation (GH-20138)

Browse source 
* bpo-26329: update os.path.normpath documentation

* Update os.path.rst

* Update posixpath.py

* update Pathname Resolution note
This commit is contained in:
Furkan Onder 2021-07-12 15:48:01 +03:00 • committed by GitHub
parent 171d529a95
commit 66c5853406
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 9 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/library/os.path.rst
View file

@ -340,6 +340,14 @@ the :mod:`glob` module.)
that contains symbolic links. On Windows, it converts forward slashes to that contains symbolic links. On Windows, it converts forward slashes to
backward slashes. To normalize case, use :func:`normcase`. backward slashes. To normalize case, use :func:`normcase`.
.. note::
On POSIX systems, in accordance with `IEEE Std 1003.1 2013 Edition; 4.13
Pathname Resolution <http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_13>`_,
if a pathname begins with exactly two slashes, the first component
following the leading characters may be interpreted in an implementation-defined
manner, although more than two leading characters shall be treated as a
single character.
.. versionchanged:: 3.6 .. versionchanged:: 3.6
Accepts a :term:`path-like object`. Accepts a :term:`path-like object`.

1
Lib/posixpath.py
View file

@ -352,6 +352,7 @@ def normpath(path):
initial_slashes = path.startswith(sep) initial_slashes = path.startswith(sep)
# POSIX allows one or two initial slashes, but treats three or more # POSIX allows one or two initial slashes, but treats three or more
# as single slash. # as single slash.
# (see http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_13)
if (initial_slashes and if (initial_slashes and
path.startswith(sep*2) and not path.startswith(sep*3)): path.startswith(sep*2) and not path.startswith(sep*3)):
initial_slashes = 2 initial_slashes = 2