Suggested changes for PEP 387 (#1533)
Fix a typo and add a bullet and reference to PEP 411 provisional APIs.
This commit is contained in:
parent
9ff31b067f
commit
3f588cb5d4
|
@ -78,6 +78,9 @@ be removed at any time in any way. These include:
|
|||
- Test suites. (Anything in the ``Lib/test`` directory or test
|
||||
subdirectories of packages.)
|
||||
|
||||
- Backward compatibility rules do not apply to any module or API that is
|
||||
explicitly documented as **Provisional** per PEP 411.
|
||||
|
||||
|
||||
Basic policy for backwards compatibility
|
||||
----------------------------------------
|
||||
|
@ -122,7 +125,7 @@ several releases:
|
|||
raise the warning. If an API is being removed, simply warn
|
||||
whenever it is entered. ``DeprecationWarning`` is the usual
|
||||
warning category to use, but ``PendingDeprecationWarning`` may be
|
||||
used in special cases were the old and new versions of the API will
|
||||
used in special cases where the old and new versions of the API will
|
||||
coexist for many releases [#warnings]_. Compiler warnings are also
|
||||
acceptable. The warning message should include the release the
|
||||
incompatibility is expected to become the default and a link to an
|
||||
|
|
Loading…
Reference in New Issue