[Python-checkins] r70438 - python/trunk/Doc/library/functions.rst

["Martin v. Löwis"]

>> I think what really needs to happen is that function.rst and
>> stdtypes.rst need to split up into multiple pages.
> 
> That may be, but the function page itself is already far too
> long.  Please move your example to the tutorial.  It is too long
> and adds too little value.  I'm strongly opposed to adding more
> of this stuff to the functions page except in cases like super()
> which are very difficult to understand without an example.

I'm strongly opposed to cluttering the tutorial with examples for
each and every language detail. Examples do belong into the library
reference. Please leave the example where it is.

Regards,
Martin