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, python-dev
Priority: normal Keywords:

Created on 2007-10-31 03:11 by giampaolo.rodola, last changed 2012-05-16 05:07 by python-dev. This issue is now closed.

Messages (6)
msg56982 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) (Python committer) 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) * (Python committer) 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) (Python committer) 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) * (Python committer) Date: 2007-11-01 17:52
It is, and this is also documented that way now.
msg57023 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) (Python committer) Date: 2007-11-01 17:58
Thanks.
msg160804 - (view) Author: Roundup Robot (python-dev) Date: 2012-05-16 05:07
New changeset 6480b23cdf48 by Julien Courteau in branch 'default':
merge #1364
http://hg.python.org/distutils2/rev/6480b23cdf48
History
Date User Action Args
2012-05-16 05:07:33python-devsetnosy: + python-dev
messages: + msg160804
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