summaryrefslogtreecommitdiffstats
path: root/Doc/library/sys.rst
diff options
context:
space:
mode:
authorVictor Stinner <victor.stinner@haypocalc.com>2011-08-21 10:08:11 (GMT)
committerVictor Stinner <victor.stinner@haypocalc.com>2011-08-21 10:08:11 (GMT)
commit795eaeb41f358d3eb14731c04fb2bd9c1da83aa4 (patch)
tree4586213c732f05aa3ed57a7c2a85c6c370a68973 /Doc/library/sys.rst
parente67474725b5b13b48ba0007e89314214a6bdca0b (diff)
downloadcpython-795eaeb41f358d3eb14731c04fb2bd9c1da83aa4.zip
cpython-795eaeb41f358d3eb14731c04fb2bd9c1da83aa4.tar.gz
cpython-795eaeb41f358d3eb14731c04fb2bd9c1da83aa4.tar.bz2
Issue #12326: update sys.platform doc for Linux
Diffstat (limited to 'Doc/library/sys.rst')
-rw-r--r--Doc/library/sys.rst19
1 files changed, 12 insertions, 7 deletions
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 517ba63..d2986e4 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -702,20 +702,21 @@ always available.
This string contains a platform identifier that can be used to append
platform-specific components to :data:`sys.path`, for instance.
- For Unix systems, this is the lowercased OS name as returned by ``uname -s``
- with the first part of the version as returned by ``uname -r`` appended,
- e.g. ``'sunos5'`` or ``'linux2'``, *at the time when Python was built*.
- Unless you want to test for a specific system version, it is therefore
- recommended to use the following idiom::
+ For Unix systems, except on Linux, this is the lowercased OS name as
+ returned by ``uname -s`` with the first part of the version as returned by
+ ``uname -r`` appended, e.g. ``'sunos5'`` or ``'freebsd8'``, *at the time
+ when Python was built*. Unless you want to test for a specific system
+ version, it is therefore recommended to use the following idiom::
- if sys.platform.startswith('linux'):
- # Linux-specific code here...
+ if sys.platform.startswith('freebsd'):
+ # FreeBSD-specific code here...
For other systems, the values are:
================ ===========================
System :data:`platform` value
================ ===========================
+ Linux ``'linux'``
Windows ``'win32'``
Windows/Cygwin ``'cygwin'``
Mac OS X ``'darwin'``
@@ -723,6 +724,10 @@ always available.
OS/2 EMX ``'os2emx'``
================ ===========================
+ .. versionchanged:: 3.3
+ On Linux, :attr:`sys.platform` doesn't contain the major version anymore.
+ It is always ``'linux'``, instead of ``'linux2'`` or ``'linux3'``.
+
.. seealso::
:attr:`os.name` has a coarser granularity. :func:`os.uname` gives
system-dependent version information.