classification
Title: os.path.isabs documentation error
Type: Stage:
Components: Documentation Versions: Python 3.0, Python 2.4, Python 2.6, Python 2.5
process
Status: closed Resolution: duplicate
Dependencies: Superseder:
Assigned To: Nosy List: giampaolo.rodola
Priority: normal Keywords:

Created on 2008-01-25 21:53 by giampaolo.rodola, last changed 2008-01-26 01:48 by mark.dickinson. This issue is now closed.

Messages (2)
msg61691 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2008-01-25 21:53
The current os.path.isabs documentation says:

> isabs(path) 
>    Return True if path is an absolute pathname (begins with a slash). 

The "begins with a slash" part is incorrect since certain systems use a
different pathname notation.
For example, on Macintosh (where os.sep == ":") this is an absolute
pathname:

hardDriveName:folderName1:folderName2:fileName.ext

...and this is a relative one:

:folderName1:fileName.ext


Moreover, on Windows os.path.isabs('\\') returns True since '\\' is an
alias for the current drive letter (e.g. C:\\) hence, independently from
what said before, the documentation should include also the "backslash"
term.
I think it would be better removing the "(begins with a slash)" part at all.
msg61694 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2008-01-25 21:58
Sorry but I had problem with my browser and I submitted the report twice:
http://bugs.python.org/issue1934
Could someone please close this one?
History
Date User Action Args
2008-01-26 01:48:48mark.dickinsonsetstatus: open -> closed
resolution: duplicate
2008-01-25 21:58:52giampaolo.rodolasetmessages: + msg61694
2008-01-25 21:53:10giampaolo.rodolacreate