Document hexversion (incompletely explained) and version_info (easily

explained).
This commit is contained in:
Fred Drake 2000-04-13 16:54:17 +00:00
parent 801c08d700
commit 4d65d73686
1 changed files with 32 additions and 0 deletions

View File

@ -138,6 +138,28 @@ generally one higher than you might expect, because it includes the
(temporary) reference as an argument to \function{getrefcount()}. (temporary) reference as an argument to \function{getrefcount()}.
\end{funcdesc} \end{funcdesc}
\begin{datadesc}{hexversion}
The version number encoded as a single integer. This is guaranteed to
increase with each version, including proper support for
non-production releases. For example, to test that the Python
interpreter is at least version 1.5.2, use:
\begin{verbatim}
if sys.hexversion >= 0x010502F0:
# use some advanced feature
...
else:
# use an alternative implementation or warn the user
...
\end{verbatim}
This is called \samp{hexversion} since it only really looks meaningful
when viewed as the result of passing it to the built-in
\function{hex()} function. The \code{version_info} value may be used
for a more human-friendly encoding of the same information.
\versionadded{1.5.2}
\end{datadesc}
\begin{datadesc}{last_type} \begin{datadesc}{last_type}
\dataline{last_value} \dataline{last_value}
\dataline{last_traceback} \dataline{last_traceback}
@ -304,6 +326,16 @@ directories (where appropriate on each platform). An example:
\end{verbatim} \end{verbatim}
\end{datadesc} \end{datadesc}
\begin{datadesc}{version_info}
A tuple containing the four components of the version number:
\var{major}, \var{minor}, \var{micro} as integers, and
\var{releaselevel} as a string. The \var{releaselevel} value will be
an empty string for a final release. The \code{version_info} value
corresponding to the \code{version} string shown above is
\code{(1, 5, 2, '')}.
\versionadded{1.6}
\end{datadesc}
\begin{datadesc}{winver} \begin{datadesc}{winver}
The version number used to form registry keys on Windows platforms. The version number used to form registry keys on Windows platforms.
This is stored as string resource 1000 in the Python DLL. The value This is stored as string resource 1000 in the Python DLL. The value