[docs] [issue14783] Update int() docstring from manual

[Raymond Hettinger]

Raymond Hettinger added the comment:

The 3.3 version has the virtue of being accurate and the vice of being confusing.  In a way, it has made the docs worse for the average user of common cases.

Is there a way to stack the alternative signatures rather than mush the various used into a single pile of mush?

    int(x=0) --> integer coercion
    int(str, base=10) --> integer converted from string in a given base

----------
nosy: +rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue14783>
_______________________________________