Fix a typo and update a sentence.

This commit is contained in:
Ezio Melotti 2011-10-24 14:00:39 +03:00
parent 1ebf91d201
commit faf9b4ce77
1 changed files with 2 additions and 3 deletions

View File

@ -87,15 +87,14 @@ process over several releases:
PEP or similar document may be written. Hopefully users of the affected API PEP or similar document may be written. Hopefully users of the affected API
will pipe up to comment. 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 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. the warning. If an API is being removed, simply warn whenever it is entered.
DeprecationWarning is the usual warning category to use, but DeprecationWarning is the usual warning category to use, but
PendingDeprecationWarning may be used in special cases were the old and new PendingDeprecationWarning may be used in special cases were the old and new
versions of the API will coexist for many releases. versions of the API will coexist for many releases.
3. Wait for a release of whichever tree (trunk or py3k) contains the 3. Wait for a release of whichever branch contains the warning.
warning.
4. See if there's any feedback. Users not involved in the original discussions 4. See if there's any feedback. Users not involved in the original discussions
may comment now after seeing the warning. Perhaps reconsider. may comment now after seeing the warning. Perhaps reconsider.