classification
Title: os.lstat documentation error
Type: Stage:
Components: Documentation Versions: Python 2.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: Nosy List: georg.brandl, giampaolo.rodola (2)
Priority: Keywords:

Created on 2007-10-31 03:11 by giampaolo.rodola, last changed 2007-11-01 17:58 by giampaolo.rodola.

Messages (5)
msg56982 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) Date: 2007-10-31 03:11
os module documentation says about lstat():

> lstat( path) 
> 
> Like stat(), but do not follow symbolic links. 
> Availability: Macintosh, Unix. 

This is not true since os.lstat() is also available under Windows
(tested under Win XP sp, Python 2.5).

Moreover, wouldn't it be better having os.lstat() available on all
platforms and turn it into an alias of os.stat on those platforms which
do not support symbolic links?
msg57015 - (view) Author: Georg Brandl (georg.brandl) Date: 2007-11-01 17:19
os.lstat is in fact an alias for os.stat on Windows.

Corrected the docs in r58745, r58746 (2.5).
msg57020 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) Date: 2007-11-01 17:50
What about other platforms?
I think it should be an alias for all platforms which does not support
symbolic links, not only Windows.
msg57021 - (view) Author: Georg Brandl (georg.brandl) Date: 2007-11-01 17:52
It is, and this is also documented that way now.
msg57023 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) Date: 2007-11-01 17:58
Thanks.
History
Date User Action Args
2007-11-01 17:58:32giampaolo.rodolasetmessages: + msg57023
2007-11-01 17:52:34georg.brandlsetmessages: + msg57021
2007-11-01 17:50:13giampaolo.rodolasetmessages: + msg57020
2007-11-01 17:19:47georg.brandlsetstatus: open -> closed
resolution: fixed
messages: + msg57015
nosy: + georg.brandl
2007-10-31 03:11:12giampaolo.rodolacreate