[Python-bugs-list] [ python-Bugs-794658 ] os.chmod docs don't say that S_IRUSR, etc, are in stat modul

[SourceForge.net]

Bugs item #794658, was opened at 2003-08-25 15:25
Message generated for change (Comment added) made by tzot
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=794658&group_id=5470

Category: Documentation
Group: Python 2.3
Status: Open
Resolution: None
Priority: 5
Submitted By: Andrew Bennetts (spiv)
Assigned to: Nobody/Anonymous (nobody)
Summary: os.chmod docs don't say that S_IRUSR, etc, are in stat modul

Initial Comment:
Section 6.1.4 currently has this to say about os.chmod:

"""chmod(path, mode)
    Change the mode of path to the numeric mode. mode
may take one of the following values:
    - S_ISUID
    [...etc...]
    - S_IXOTH

Availability: Unix, Windows.
"""

However, those values aren't defined in the os module,
they are defined in the stat module.  The docs should
point this out, because this isn't obvious
(particularly since os.access in the same section takes
similar-looking constants that *are* found in the os
module).

Off the top of my head, changing the wording to "mode
may take one of the following values (which are defined
in the stat module): ..." would do (appropriately
hyperlinked, of course).

Thanks!

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

Comment By: Christos Georgiou (tzot)
Date: 2003-08-29 11:55

Message:
Logged In: YES 
user_id=539787

See patch 797157

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

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