Elaborate that some packages may have different compatibility

requirements based on the branch of Python they're developed on.
This commit is contained in:
Barry Warsaw 2003-12-04 15:12:55 +00:00
parent c2ae605f20
commit 246bdd7250
1 changed files with 24 additions and 6 deletions

View File

@ -14,7 +14,9 @@ Abstract
This PEP describes the packages and modules in the standard
library which should remain backward compatible with previous
versions of Python.
versions of Python. If a package is not listed here, then it need
only remain compatible with the version of Python it is
distributed with.
Rationale
@ -34,6 +36,13 @@ Rationale
authors must add a comment at the top of each file documenting
the compatibility requirement.
When a major version of Python is released, a CVS branch is
created for continued maintenance and bug fix releases. A package
version on a branch may have a different compatibility requirement
than the same package on the trunk (i.e. current bleeding-edge
development). Where appropriate, these branch compatibilities are
listed below.
Features to Avoid
@ -66,18 +75,18 @@ Features to Avoid
Backward Compatible Packages, Modules, and Tools
Package/Module Maintainer(s) Python Version
-------------- ------------- --------------
Package/Module Maintainer(s) Python Version Notes
-------------- ------------- -------------- -----
bsddb Barry Warsaw 2.1
compiler Jeremy Hylton 2.1
distutils Andrew Kuchling 1.5.2
email Barry Warsaw 2.1
email Barry Warsaw 2.1 / 2.3 [1]
logging Vinay Sajip 1.5.2
sre Fredrik Lundh 2.1
xml (PyXML) Martin v. Loewis 2.0
xmlrpclib Fredrik Lundh 1.5.2
modulefinder Thomas Heller, Just van Rossum
2.2
modulefinder Thomas Heller
Just van Rossum 2.2
Tool Maintainer(s) Python Version
@ -85,6 +94,15 @@ Backward Compatible Packages, Modules, and Tools
None
Notes
-----
[1] The email package version 2 was distributed with Python up to
Python 2.3, and this must remain Python 2.1 compatible. email
package version 3 will be distributed with Python 2.4 and will
need to remain compatible only with Python 2.3.
Copyright
This document has been placed in the public domain.