homepage

I am trying to port some app from 2.x to 3.x
Terry Reedy suggested using 2.7
I get deprecation warnings (with -3 flag)
I would be good to have a place to check all such and have suggested solutions

Are the warnings originating in your code, or in the standard library, or elsewhere?
If in the standard library, please provide specific details.

Hi Eric
Sorry for not being clear.
This is more of a feature request than a bug report as suggested by Terry
Reedy on the python mailing list (see here
http://mail.python.org/pipermail/python-list/2010-December/1262149.html
The warnings are in my code.
The main problems are (I expect) from strings/unicode/binary-strings
I am suggesting that it would be good to have a place one could go to with
each such warnings that would give explanations and possible remedies
Rusi
On Fri, Dec 10, 2010 at 3:05 PM, Eric Smith <report@bugs.python.org> wrote:
>
> Eric Smith <eric@trueblade.com> added the comment:
>
> Are the warnings originating in your code, or in the standard library, or
> elsewhere?
>
> If in the standard library, please provide specific details.
>
> ----------
> nosy: +eric.smith
>
> _______________________________________
> Python tracker <report@bugs.python.org>
> <http://bugs.python.org/issue10669>
> _______________________________________
>

The issue is not the specific warnings Rusi got but how, in general, one can get more information when the warnings are too cryptic to deal with.
One response might be that DeprecationWarnings should be much wordier than they are -- a paragraph of a few sentences rather than just a minimal sentence. Another might be that each release have a HOW-TO doc or What's New section with a paragraph for each one added to that release.
Currently, information is scattered among pydev posts, tracker issues, commit messages, News entries, and maybe What's new.

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.

FWIW, whatsnew is not primary documentation -- it should not be the sole or central source of anything except a highlevel overview and examples for the author's choice of selected version differences to highlight. 
A howto document would work best as a central place to list all deprecations and advice on what to do about them.

PEP 4 and PEP 290 are related to this subject, but not comprehensive, not on docs.python.org, and not tutorial-like.
I think we could try Ezio’s idea. Sphinx can produce a document containing only version* directives ("make changes"). If such a document is clear enough and has links to the longer docs, there would be no need to write separate howtos.

If this is change is still desirable, I think it might be a good issue for someone who had contributed a few patches and is looking for something a little more challenging to work on.