From: Jason R. Coombs Date: Sun, 30 Oct 2022 15:53:58 +0000 (-0400) Subject: gh-97966: Update uname docs to clarify the special nature of the platform attribute... X-Git-Tag: v3.12.0a2~195 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=018b2483c422031ba5a6084238ab66ba44ea9fcf;p=thirdparty%2FPython%2Fcpython.git gh-97966: Update uname docs to clarify the special nature of the platform attribute and to indicate when it became late-bound. (#97972) --- diff --git a/Doc/library/platform.rst b/Doc/library/platform.rst index dc2d871b47d5..a0c9f63ab9f9 100644 --- a/Doc/library/platform.rst +++ b/Doc/library/platform.rst @@ -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 ------------- diff --git a/Misc/NEWS.d/next/Documentation/2022-10-06-13-00-28.gh-issue-97966.fz7kFg.rst b/Misc/NEWS.d/next/Documentation/2022-10-06-13-00-28.gh-issue-97966.fz7kFg.rst new file mode 100644 index 000000000000..8240442a3bcb --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2022-10-06-13-00-28.gh-issue-97966.fz7kFg.rst @@ -0,0 +1,2 @@ +Update uname docs to clarify the special nature of the platform attribute +and to indicate when it became late-bound.