Skip to content

gh-101100: Resolve some os sphinx reference warnings#139636

Merged
kumaraditya303 merged 6 commits into
python:mainfrom
cmaloney:warnings_os_stat
Oct 8, 2025
Merged

gh-101100: Resolve some os sphinx reference warnings#139636
kumaraditya303 merged 6 commits into
python:mainfrom
cmaloney:warnings_os_stat

Conversation

@cmaloney

@cmaloney cmaloney commented Oct 6, 2025

Copy link
Copy Markdown
Contributor

Individual commits have more details around each case.


This + GH-139592 get os down to two reference warning sources:

  1. os.statvfs() pieces which need docs written for both the return object attributes (f_bsize, ...) as well as os constants (ST_RDONLY, ...)
  2. os.uname() pieces which need docs written for the return object attributes (sysname, nodename, ...)

Planning to work on those to get os reference warnings clean once learn from these two PRs


📚 Documentation preview 📚: https://cpython-previews--139636.org.readthedocs.build/

Point to either the constants in `stat` or to
`os.stat_result` as needed.
Reference `dict` as os.environ emulates that and
`collections.abc.MutableMapping` doesn't have members defined.
Change to similar sample code used in `free-threading-python.rst`
@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Oct 6, 2025
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Oct 6, 2025
Comment thread Doc/library/os.rst Outdated
Comment thread Doc/library/os.rst Outdated
cmaloney and others added 2 commits October 8, 2025 10:27
Co-authored-by: Victor Stinner <vstinner@python.org>
@kumaraditya303 kumaraditya303 merged commit fa60354 into python:main Oct 8, 2025
27 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Oct 8, 2025
@cmaloney cmaloney deleted the warnings_os_stat branch October 8, 2025 19:08
@cmaloney cmaloney added the needs backport to 3.14 bugs and security fixes label Jun 20, 2026
@miss-islington-app

Copy link
Copy Markdown

Thanks @cmaloney for the PR, and @kumaraditya303 for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

@bedevere-app

bedevere-app Bot commented Jun 20, 2026

Copy link
Copy Markdown

GH-151765 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Jun 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir skip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants