Ezio Melotti <ezio.melo...@gmail.com> added the comment:

The deprecation notes in the doc should be quite easy to find and can be more 
verbose, but there are a few cases where the deprecation is not about a 
specific function but something more "abstract" (e.g. some syntax change, or 
the "Overriding __eq__ blocks inheritance of __hash__ in 3.x" reported by the 
OP).
Listing new deprecations in the what's new it's a good idea, but otherwise a 
clear message (that also suggests how to fix the problem) and a deprecation 
note in the doc (using the '.. deprecated::' directive) should be enough.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue10669>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to