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: fixed
Dependencies: Superseder:
Assigned To: Nosy List: georg.brandl, giampaolo.rodola
Priority: normal Keywords:

Created on 2008-01-25 21:54 by giampaolo.rodola, last changed 2008-01-26 11:02 by georg.brandl. This issue is now closed.

Messages (4)
msg61692 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2008-01-25 21:54
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.
msg61701 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2008-01-26 09:43
Fixed in r60314. Thanks for the report!
msg61704 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2008-01-26 10:23
> Return ``True`` if *path* is an absolute pathname.  On Unix, that 
> means it begins with a slash, on Windows that it begins with a 
> backslash after chopping off a potential drive letter.

Actually the Windows part is not completely true since on Windows
pathnames containing slashes ('/') are also permitted and treated as if
they were backslashes ('\\').

>>> os.path.isabs('/')
True
>>> os.path.isabs('C:/')
True
>>> os.path.isabs('C:\\/')
True
msg61706 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2008-01-26 11:02
Okay, fixed in r60317.
History
Date User Action Args
2008-01-26 11:02:30georg.brandlsetmessages: + msg61706
2008-01-26 10:23:04giampaolo.rodolasetmessages: + msg61704
2008-01-26 09:43:43georg.brandlsetstatus: open -> closed
resolution: fixed
messages: + msg61701
nosy: + georg.brandl
2008-01-25 21:54:53giampaolo.rodolacreate