➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ezio.melotti
Recipients cvrebert, docs@python, eric.araujo, ezio.melotti, georg.brandl, rhettinger, terry.reedy, tshepang
Date 2012-09-01.09:30:07
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1346491808.25.0.798760306297.issue14783@psf.upfronthosting.co.za>
In-reply-to
Content 
The issues about "weird" signatures are being discussed on #15831.

> However, this issue is about the docstring. Leave it incorrect?
> Change it to the hard-to-parse one liner? Change it to a 
> two-line signature also?

For the docstring it's ok to use the double signature too.  The description, while not too comprehensive, is understandable.
The description of int() in the docs is instead a bit complicated.  The content is good, but IMHO it would be more understandable if it was broken down into paragraphs or into a list.
History
Date User Action Args
2012-09-01 09:30:08ezio.melottisetrecipients: + ezio.melotti, georg.brandl, rhettinger, terry.reedy, eric.araujo, cvrebert, docs@python, tshepang
2012-09-01 09:30:08ezio.melottisetmessageid: <1346491808.25.0.798760306297.issue14783@psf.upfronthosting.co.za>
2012-09-01 09:30:07ezio.melottilinkissue14783 messages
2012-09-01 09:30:07ezio.melotticreate