[docs] [issue23079] os.path.normcase documentation confusing

[Chris Jerdonek]

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 at python
components: Documentation, Library (Lib)
messages: 232871
nosy: chris.jerdonek, docs at 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 <report at bugs.python.org>
<http://bugs.python.org/issue23079>
_______________________________________