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

[Benjamin Peterson]

2009/3/17 Raymond Hettinger <python at rcn.com> schrieb:
> Look at the main Java
> docs for comparison.  They are shot and sweet and say what
> a function does, period.

Telling precisely what a function does is important, but to take a
cliche, "a code example tells a thousand words." Functions aren't used
alone in programs; they're in context. Examples provide higher level
guidance about how a function is usually used.



-- 
Regards,
Benjamin