[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Zachary Ware]

Zachary Ware added the comment:

Dave, your patch is a significant improvement on the accuracy of the current 
doc, but the whole paragraph seems somewhat haphazard and confusing to me.  
Here's my own attempt to clean it up, though I'm not certain just how much 
improvement it is :)

--
nosy: +zach.ware
Added file: http://bugs.python.org/file36872/issue15414.diff

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Serhiy Storchaka]

Changes by Serhiy Storchaka :


--
keywords: +needs review
stage:  -> patch review
versions: +Python 2.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Brian Curtin]

Changes by Brian Curtin :


--
nosy:  -brian.curtin

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Mark Lawrence]

Mark Lawrence added the comment:

ntpath.join() was fixed in issue19456 so I think all we need here is a commit 
review of the attached documentation patch.

--
nosy: +BreamoreBoy

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Dave Sawyer]

Changes by Dave Sawyer :


--
versions: +Python 3.4, Python 3.5 -Python 2.7, Python 3.2, Python 3.3

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Dave Sawyer]

Changes by Dave Sawyer :


--
keywords: +patch
Added file: http://bugs.python.org/file34956/joindoc.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Dave Sawyer]

Dave Sawyer added the comment:

http://bugs.python.org/issue1669539 has been partially fixed. On Windows 
os.path.join('foo', 'a:bar') gives 'a:bar' not 'foo\\a:bar'. However 
os.path.isabs('a:bar') returns False yet it causes a reset in the join like an 
absolute path.

'\foo' is considered an absolute path even though calling os.path.abspath on it 
can yield different results - as if it were a relative path. At minimum we 
should amend the wording about what resets the join.

--
nosy: +dsawyer

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[Martin Dengler]

Changes by Martin Dengler :


--
nosy: +mdengler

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15414] os.path.join behavior on Windows (ntpath.join) is unexpected and not well documented

[R. David Murray]

New submission from R. David Murray :

In looking at another os.path.join documentation issue I tried the Windows join 
to see if it matched the docs, and found that it was very unclear.   I searched 
the tracker and found Issue 1669539, which contains much relevant discussion 
but also much discussion of possible enhancements.  So I'm opening a new issue 
*just* about what I see as the current bugs in the os.path.join docs and 
ntpath.join implementation.

I'm not qualified to fix this, not being a Windows user, but it is clear to me 
that the documentation of os.path.join for Windows is unclear (it does not 
indicate what is considered an absolute path on Windows) and wrong (\foo will 
*not* restart the path if it is the second element and follows a drive 
specification, but it does any other time), and that the current behavior may 
have a bug if, as seems to be implied by the issue 1669539 discussion, 
something that looks like a drive specification in the middle of a path is 
invalid on Windows.  If this last is not a bug, it should be mentioned in the 
documentation, since the actual behavior is counter-intuitive.

--
assignee: docs@python
components: Documentation, Windows
keywords: easy
messages: 166065
nosy: brian.curtin, christian.heimes, docs@python, eckhardt, ezio.melotti, 
jorend, mhammond, r.david.murray, terry.reedy, tim.golden
priority: normal
severity: normal
status: open
title: os.path.join behavior on Windows (ntpath.join) is unexpected and not 
well documented
type: behavior
versions: Python 2.7, Python 3.2, Python 3.3

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com