gh-97966: Update uname docs to clarify the special nature of the platform attribute and to indicate when it became late-bound. (#97972)

This commit is contained in:
Jason R. Coombs 2022-10-30 11:53:58 -04:00 committed by GitHub
parent 05e48865be
commit 018b2483c4
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 10 additions and 4 deletions

View file

@ -168,16 +168,20 @@ Cross Platform
containing six attributes: :attr:`system`, :attr:`node`, :attr:`release`,
:attr:`version`, :attr:`machine`, and :attr:`processor`.
Note that this adds a sixth attribute (:attr:`processor`) not present
in the :func:`os.uname` result. Also, the attribute names are different
for the first two attributes; :func:`os.uname` names them
:attr:`sysname` and :attr:`nodename`.
:attr:`processor` is resolved late, on demand.
Note: the first two attribute names differ from the names presented by
:func:`os.uname`, where they are named :attr:`sysname` and
:attr:`nodename`.
Entries which cannot be determined are set to ``''``.
.. versionchanged:: 3.3
Result changed from a tuple to a :func:`~collections.namedtuple`.
.. versionchanged:: 3.9
:attr:`processor` is resolved late instead of immediately.
Java Platform
-------------

View file

@ -0,0 +1,2 @@
Update uname docs to clarify the special nature of the platform attribute
and to indicate when it became late-bound.