[docs] Confusion in os.path documentation

Reuben Thomas rrt at sc3d.org
Wed Dec 14 17:54:30 CET 2011


In the following, from the os.path documentation, the second sentence
sounds like it’s referring to a consequence of the first, but it’s
not: normalizing paths containing symbolic links can change their
meaning:
"On Windows, it converts forward slashes to backward slashes. It
should be understood that this may change the meaning of the path if
it contains symbolic links!"
Hence, I suggest the following rewrite:
"On Windows, it converts forward slashes to backward slashes. Note
that normpath() may change the meaning of the path if it contains
symbolic links!"
-- 
http://rrt.sc3d.org


More information about the docs mailing list