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

[Raymond Hettinger]

[MvL]
> However, I'd rather prefer to see some general solution for
> moving examples out of the reader's flow if he doesn't want
> them (e.g. by having two versions of the page, or using
> JS trickery).

That seems like a good idea for HTML docs but we should 
probably have a larger discussion on whether the docs
need to retain their usability in printed form.   The docs
probably need to be staticly usable and not just accessible
through a browser or PDF viewer.

I could see having links to a docs wiki.  That way, people
can load-up examples, comments, links to real-world
code and whatnot  while leading the main docs uncluttered.


Raymond