#11901: add description of how bitfields are laid out to hexversion docs

Patch by Sijin Joseph.
This commit is contained in:
R David Murray 2011-04-25 16:10:18 -04:00
parent f93bb262eb
commit a0895db2e1
2 changed files with 25 additions and 0 deletions

View File

@ -562,6 +562,30 @@ always available.
``version_info`` value may be used for a more human-friendly encoding of the ``version_info`` value may be used for a more human-friendly encoding of the
same information. same information.
The ``hexversion`` is a 32-bit number with the following layout
+-------------------------+------------------------------------------------+
| bits (big endian order) | meaning |
+=========================+================================================+
| :const:`1-8` | ``PY_MAJOR_VERSION`` (the ``2`` in |
| | ``2.1.0a3``) |
+-------------------------+------------------------------------------------+
| :const:`9-16` | ``PY_MINOR_VERSION`` (the ``1`` in |
| | ``2.1.0a3``) |
+-------------------------+------------------------------------------------+
| :const:`17-24` | ``PY_MICRO_VERSION`` (the ``0`` in |
| | ``2.1.0a3``) |
+-------------------------+------------------------------------------------+
| :const:`25-28` | ``PY_RELEASE_LEVEL`` (``0xA`` for alpha, |
| | ``0xB`` for beta, ``0xC`` for gamma and |
| | ``0xF`` for final) |
+-------------------------+------------------------------------------------+
| :const:`29-32` | ``PY_RELEASE_SERIAL`` (the ``3`` in |
| | ``2.1.0a3``) |
+-------------------------+------------------------------------------------+
thus ``2.1.0a3`` is hexversion ``0x020100a3``
.. versionadded:: 1.5.2 .. versionadded:: 1.5.2

View File

@ -411,6 +411,7 @@ Irmen de Jong
Lucas de Jonge Lucas de Jonge
John Jorgensen John Jorgensen
Jens B. Jorgensen Jens B. Jorgensen
Sijin Joseph
Andreas Jung Andreas Jung
Tattoo Mabonzo K. Tattoo Mabonzo K.
Bob Kahn Bob Kahn