Author terry.reedy
Recipients KayEss, Rhamphoryncus, benjamin.peterson, blakeross, georg.brandl, gregory.p.smith, gvanrossum, jaraco, jcea, jonash, rhettinger, terry.reedy
Date 2013-01-15.02:47:35
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1358218056.83.0.425738467764.issue1683368@psf.upfronthosting.co.za>
In-reply-to
Content
First, What's New " explains the new features in Python". This issue is a bugfix. AFAIK, object() has always been documented as having no parameters. The fact that passing extra args should raise a TypeError is no secret.

Second, this *is* documented. The third sentence of
http://docs.python.org/3/whatsnew/3.3.html
is " For full details, see the changelog." We really mean that ;-). The changelog is derived from Misc/NEWS in the repository. It says "Issue #1683368: object.__new__ and object.__init__ raise a TypeError if they are passed arguments and their complementary method is not overridden." That is prefixed by "Issue #1683368:", which links to this issue. This entry is easily found by searching for 'object.__init__' (or a sufficient prefix thereof).

For 3.2, the What's New sentence was "For full details, see the Misc/NEWS file" and the link went to the raw repository file.
http://hg.python.org/cpython/file/3.2/Misc/NEWS
My impression is that this issue played a role in including the prettified version, instead of just the repository link, in the on-line version of the docs. What's New for 2.7 does not even have the link.

In any case, *any* bugfix breaks code that depends on the bug. Hence the decision to make the full changelog more available and more readable.

I realize that the change to the header for What's New is hard to miss. But what are we to do? Add a new What's New in What's New doc for one release? Put the change in flashing red type?
History
Date User Action Args
2013-01-15 02:47:37terry.reedysetrecipients: + terry.reedy, gvanrossum, georg.brandl, rhettinger, gregory.p.smith, jcea, jaraco, Rhamphoryncus, blakeross, benjamin.peterson, KayEss, jonash
2013-01-15 02:47:36terry.reedysetmessageid: <1358218056.83.0.425738467764.issue1683368@psf.upfronthosting.co.za>
2013-01-15 02:47:36terry.reedylinkissue1683368 messages
2013-01-15 02:47:35terry.reedycreate