This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author gsingh
Recipients docs@python, gsingh
Date 2013-03-14.09:41:24
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1363254084.71.0.566046555071.issue17415@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2013-03-14 09:41:24gsinghsetrecipients: + gsingh, docs@python
2013-03-14 09:41:24gsinghsetmessageid: <1363254084.71.0.566046555071.issue17415@psf.upfronthosting.co.za>
2013-03-14 09:41:24gsinghlinkissue17415 messages
2013-03-14 09:41:24gsinghcreate