diff --git a/pep-0387.txt b/pep-0387.txt index 04f765eb7..ba008d51c 100644 --- a/pep-0387.txt +++ b/pep-0387.txt @@ -87,15 +87,14 @@ process over several releases: PEP or similar document may be written. Hopefully users of the affected API will pipe up to comment. -2. Add a warning [#warnings]_. If behavior is changing, a the API may gain a +2. Add a warning [#warnings]_. If behavior is changing, the API may gain a new function or method to perform the new behavior; old usage should 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 coexist for many releases. -3. Wait for a release of whichever tree (trunk or py3k) contains the - warning. +3. Wait for a release of whichever branch contains the warning. 4. See if there's any feedback. Users not involved in the original discussions may comment now after seeing the warning. Perhaps reconsider.