gh-101675: Fix os Windows-supported file permissions

[180909]

• Issue: Documentation is self-contradictory regarding Windows-supported file permissions #101675

[eryksun]

You missed S_IEXEC. It's used in the st_mode 'permissions' returned by os.stat() for directories and for filenames with an extension that's ".exe", ".com", ".bat", or ".cmd".

This has nothing to do with actual execute permission granted to the file's owner, group, or any user.

[github-actions]

This PR is stale because it has been open for 30 days with no activity.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #32915861 | 📁 Comparing fb43ff7 against main (62a45fa)

  🔍 Preview build  

1 file changed

± library/stat.html

[serhiy-storchaka]

Please update also the stat module docstring (in Modules/_stat.c).

And maybe add the same for S_IEXEC?

Also, I think that S_IREAD should be removed from the os.chmod() documentation. All except S_IWRITE is ignored.

[bedevere-app]

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.