New submission from Gurmeet Singh:

This is the first time I am creating an issue. I may be doing something wrong. 
I will correct that if you make me aware about it!

Issue with documentation:
Documentation page: http://docs.python.org/3/library/os.path.html
Entry: os.path.normpath(path)
Contention line: "It should be understood that this may change the meaning of 
the path if it contains symbolic links!"

Ambiguity Source: Contention line immediately follows the line "On Windows, it 
converts forward slashes to backward slashes." relating contention line to also 
windows.

Ambiguity: "I think" (i.e. I do not know for sure) that, the contention line 
should apply to all OS, not just windows. for example, .. after a symlink 
should, according to me, remove the symlink itself by the normpath function. 
This would be an incorrect behaviour of the normpath (I consider that 
incorrect). Hence, should be documented for all OS.

----------
assignee: docs@python
components: Documentation
messages: 184152
nosy: docs@python, gsingh
priority: normal
severity: normal
status: open
title: Documentation Ambiguity 1
type: enhancement
versions: Python 3.3

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

Reply via email to