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

[Georg Brandl]

Antoine Pitrou schrieb:
> Nick Coghlan <ncoghlan <at> gmail.com> writes:
>> 
>> Perhaps the page just needs an overview section or table at the start
>> that just gives a one line description of each method, and then links to
>> the more detailed descriptions with longer examples?
> 
> Or perhaps the examples should be folded by default in the HTML rendering, with
> a simple way (a '+' sign or something) to unfold them. This is not even AJAX,
> just simple Javascript grafted on an otherwise static HTML page.

Not a bad idea.  Some directive to mark a block of docs as "small print" that
can be extended by JS (or is always displayed, maybe in smaller font, if JS is
not supported) is easy to do.  However, I fear that if it's used too much,
people will get annoyed.

Let's discuss this a bit more on the docs list.

Georg

-- 
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.