Right now many of the os function docs are split up into "Files and directories" and "file descriptor operations". This means, for example, that fchmod() and fchmodat() are in a different section than chmod(). It would make more sense to organize the docs such that functions that do the same thing are right next to each other.

Also, symbolic constants should be close to the functions they are used in. For example, open() flags shouldn't be in their own section.

+1

I was attempting to create a patch for this but all I have is moving fchmod() below chmod(). I was unable to find fchmodat() in os.rst. And I need further clarification on 

>>Also, symbolic constants should be close to the functions they are used >>in. For example, open() flags shouldn't be in their own section.

Mike Hoy: a later patch (http://bugs.python.org/issue14626) changed the API in the os module so that the wrappers for *at() functions went away; fchmod() now takes several different forms of argument and calls the correct function under the hood.

New changeset 88edac3bc2fc by Andrew Kuchling in branch 'default':
#12716: reorganize docs for os module a bit
http://hg.python.org/cpython/rev/88edac3bc2fc

I didn't see any other constants that aren't close to the function they're used with.  Can this issue be closed, or are there other changes to make?

Closing this issue after a week.  Mike Hoy: thanks for your patch.