Message 170711 - Python tracker

Message170711

Author	ezio.melotti
Recipients	cvrebert, docs@python, eric.araujo, ezio.melotti, georg.brandl, rhettinger, serhiy.storchaka, terry.reedy, tshepang
Date	2012-09-19.07:58:08
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1348041489.19.0.418718928189.issue14783@psf.upfronthosting.co.za>
In-reply-to

Content
> First argument is named "x". Sometimes the doc uses "better" names to improve clarity when the argument is not supposed to be called as keyword arg. > Here can be not only string, but bytes or bytearray. The same applies here. "string" is also used in the error message (int() can't convert non-string with explicit base). If bytes/bytearrays are accepted too it could be mentioned later in the prose. Otherwise we could use x for both, but the distinction would be less clear.

Content

> First argument is named "x".

Sometimes the doc uses "better" names to improve clarity when the argument is not supposed to be called as keyword arg.

> Here can be not only string, but bytes or bytearray.

The same applies here.  "string" is also used in the error message (int() can't convert non-string with explicit base).  If bytes/bytearrays are accepted too it could be mentioned later in the prose.

Otherwise we could use x for both, but the distinction would be less clear.

History
Date	User	Action	Args
2012-09-19 07:58:09	ezio.melotti	set	recipients: + ezio.melotti, georg.brandl, rhettinger, terry.reedy, eric.araujo, cvrebert, docs@python, tshepang, serhiy.storchaka
2012-09-19 07:58:09	ezio.melotti	set	messageid: <1348041489.19.0.418718928189.issue14783@psf.upfronthosting.co.za>
2012-09-19 07:58:08	ezio.melotti	link	issue14783 messages
2012-09-19 07:58:08	ezio.melotti	create