[gentoo-dev] Python-3.2-related changes

[Arfrever Frehtes Taifersar Arahesis <Arfrever@gentoo.org>]

[-- Attachment #1: Type: Text/Plain, Size: 2153 bytes --]

It is planned that ebuilds of Python 3.2 will automatically set Python 3.2 as main active
version of Python. (Currently ebuilds of Python 3.1 do not automatically set Python 3.1
as main active version of Python.) Final release of Python 3.2 is currently scheduled on
2010-12-11, so you have over 10 months for adjusting of your ebuilds.

The following changes should be made in ebuilds of packages supporting only Python 2:
- Dependency on Python 2 should be set correctly. You can specify it directly in
  {,R}DEPEND or use PYTHON_DEPEND.

    Example:
      PYTHON_DEPEND="2"

      inherit python

- Miscellaneous actions should be executed with correct version of Python.

  - In ebuilds of packages supporting installation for multiple versions of Python,
    please remember to disable installation for all versions of Python 3.
    (Please do not use python_set_active_version() in ebuilds of these packages.)

    Example:
      RESTRICT_PYTHON_ABIS="3.*"

  - In ebuilds of packages not supporting installation for multiple versions of Python,
    set active version of Python using python_set_active_version().
    (Please avoid passing precisely specified Python ABI to python_set_active_version().)

    Example:
      pkg_setup() {
          python_set_active_version 2
      }

    (If given package currently cannot be installed for multiple versions of Python,
    but it is theoretically possible (e.g. this package installs .py files into
    /usr/lib/pythonX.Y/site-packages and does not install any non-versioned libraries
    into /usr/lib), then please try to adjust ebuilds of this package to allow
    installation for multiple versions of Python.)

It is recommended to have set a version of Python 3 as main active version of Python
during testing of these changes to ensure that no required change has been missed.

I consider filing bugs for not adjusted packages after some months (e.g in summer).
(Please note that these changes are not required before stabilization of Python 3.1,
so stabilization of Python 3.1 will not be delayed.)

-- 
Arfrever Frehtes Taifersar Arahesis

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 836 bytes --]