➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: os.chmod is underdocumented :-)
Type: Stage:
Components: Documentation Versions: Python 2.2
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: rhettinger Nosy List: bpettersen, rhettinger
Priority: normal Keywords:

Created on 2002-08-08 22:46 by bpettersen, last changed 2022-04-10 16:05 by admin. This issue is now closed.

Messages (3)
msg11887 - (view) Author: Bjorn Pettersen (bpettersen) Date: 2002-08-08 22:46 
Currently it says: "Change the mode of path to the 
numeric mode." I spent some time trying to figure out 
what mode should be on Windows before I looked in 
MSDN and did a grep over the Python Lib.

Could we add: "Constants defined for the numeric mode 
parameter are defined in the stat module. E.g. to make 
a file writable:

  os.chmod(filename, S_IWUSR|S_IWGRP|S_IWOTH)

or simply

  os.chmod(filename, S_IWRITE)

on Windows.
"

It would probably be a good idea to list the names for 
the permission bits in the stat docs also...

-- bjorn
msg11888 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2002-08-09 01:44 
Logged In: YES 
user_id=80475

I agree that the current docs are as clear as mud.
Will draft a clarification.
msg11889 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2003-01-06 13:33 
Logged In: YES 
user_id=80475

Fixed.
See Doc/lib/libos.tex 1.108
History
Date User Action Args
2022-04-10 16:05:34adminsetgithub: 37009
2002-08-08 22:46:25bpettersencreate