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:
Barry Warsaw 2020-07-20 10:10:55 -07:00 committed by GitHub
parent 9ff31b067f
commit 3f588cb5d4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 1 deletions

View File

@ -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