[Python-bugs-list] [ python-Bugs-755617 ] os module: Need a better description of "mode"

[SourceForge.net]

Bugs item #755617, was opened at 2003-06-16 17:13
Message generated for change (Comment added) made by mshomphe
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=755617&group_id=5470

Category: Documentation
Group: Python 2.3
Status: Open
Resolution: None
Priority: 5
Submitted By: Matthew Shomphe (mshomphe)
Assigned to: Nobody/Anonymous (nobody)
Summary: os module: Need a better description of "mode"

Initial Comment:
The page <http://www.python.
org/doc/current/lib/os-file-dir.html> says the following 
about the function os.chmod:

chmod(path, mode) 
Change the mode of path to the numeric mode. 
Availability: Unix, Windows. 

The "mode" values are unclear.  It turns out that the 
UNIX file permission set (e.g., 0666 for read/writeable) 
works with the Windows set (where 0666 translates to  
33206).

Is it possible to describe the file permissions in more 
detail in the documentation at this point?

Attached is an email thread discussing this 
documentation issue.

----------------------------------------------------------------------

>Comment By: Matthew Shomphe (mshomphe)
Date: 2003-06-16 19:05

Message:
Logged In: YES 
user_id=716326

Here's my first pass at some additional documentation.  My 
HTML skills are not up to par, but I've tried :)  I've attached 
the document separately.

m@

----------------------------------------------------------------------

Comment By: Neal Norwitz (nnorwitz)
Date: 2003-06-16 18:06

Message:
Logged In: YES 
user_id=33168

Could you try to produce a patch to improve the
documentation?  Or perhaps suggest better wording?

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=755617&group_id=5470