From 795eaeb41f358d3eb14731c04fb2bd9c1da83aa4 Mon Sep 17 00:00:00 2001 From: Victor Stinner Date: Sun, 21 Aug 2011 12:08:11 +0200 Subject: Issue #12326: update sys.platform doc for Linux --- Doc/library/sys.rst | 19 ++++++++++++------- 1 file 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. -- cgit v0.12