Fix a typo and update a sentence.
This commit is contained in:
parent
1ebf91d201
commit
faf9b4ce77
|
@ -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.
|
||||||
|
|
Loading…
Reference in New Issue