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 eric.araujo
Recipients docs@python, eli.bendersky, eric.araujo, pitrou
Date 2011-08-11.16:02:44
SpamBayes Score 5.4229407e-05
Marked as misclassified No
Message-id <1313078565.32.0.00276556211233.issue12672@psf.upfronthosting.co.za>
In-reply-to
Content
> I know perfectly well that [].append is valid Python,
> but I don't think this is the clearest way to give an example of an
> object method. I think spelling [].append's meaning more explicitly
> would be better.
Would it be clearer if we replaced the literal with a name?

  These C functions are called “type methods” to distinguish them from
- things like [].append (which we call “object methods”).
+ methods bound to specific instances (things like sys.path.append),
+ which we call “object methods”.

> I'm also aware that there are tab problems all over the code base.
> I'm not suggesting a large cleanup.
*I* was suggesting a large cleanup :), but we can do that in another commit.  If you want to clean the example code in Doc/extending or even just in newtypes.rst, I think you can just go ahead.
History
Date User Action Args
2011-08-11 16:02:45eric.araujosetrecipients: + eric.araujo, pitrou, eli.bendersky, docs@python
2011-08-11 16:02:45eric.araujosetmessageid: <1313078565.32.0.00276556211233.issue12672@psf.upfronthosting.co.za>
2011-08-11 16:02:44eric.araujolinkissue12672 messages
2011-08-11 16:02:44eric.araujocreate