New submission from Chris Jerdonek:

The documentation for os.path.normcase(path) is currently confusing or 
self-contradictory.

Currently, it reads--

"Normalize the case of a pathname. On Unix and Mac OS X, this returns the path 
unchanged; on case-insensitive filesystems, it converts the path to lowercase."

However, with a case-insensitive file system on Mac OS X (e.g. "File System 
Personality: Journaled HFS+"), normcase() does not convert paths to lowercase.

As it stands, it seems like the clause "on case-insensitive filesystems, it 
converts the path to lowercase" should be removed or further qualified.  I 
don't know what the qualification is though.

----------
assignee: docs@python
components: Documentation, Library (Lib)
messages: 232871
nosy: chris.jerdonek, docs@python
priority: normal
severity: normal
status: open
title: os.path.normcase documentation confusing
type: behavior
versions: Python 2.7, Python 3.4, Python 3.5

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue23079>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to