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
|
||||
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.
|
||||
|
|
Loading…
Reference in New Issue