Add a discussion section

This commit is contained in:
Antoine Pitrou 2013-10-25 21:28:38 +02:00
parent e4f08b7f30
commit 0851a088fc
1 changed files with 36 additions and 0 deletions

View File

@ -656,6 +656,42 @@ Several common filesystem operations are provided as methods: ``touch()``,
provided, for example some of the functionality of the shutil module.
Discussion
==========
Division operator
-----------------
The division operator came out first in a `poll`_ about the path joining
operator. Initial versions of `pathlib`_ used square brackets
(i.e. ``__getitem__``) instead.
.. _poll: https://mail.python.org/pipermail/python-ideas/2012-October/016544.html
joinpath()
----------
The joinpath() method was initially called join(), but several people
objected that it could be confused with str.join() which has different
semantics. Therefore it was renamed to joinpath().
Case-sensitivity
----------------
Windows users consider filesystem paths to be case-insensitive and expect
path objects to observe that characteristic, even though in some rare
situations some foreign filesystem mounts may be case-sensitive under
Windows.
In the words of one commenter,
"If glob("\*.py") failed to find SETUP.PY on Windows, that would be a
usability disaster".
-- Paul Moore in
https://mail.python.org/pipermail/python-dev/2013-April/125254.html
Copyright
=========