Python Documentation (should be better?)

[Sébastien Boisgérault]

Christopher J. Bottaro wrote:

> [...]

> Cuz I think the Language Reference is really more of a grammer
reference and
> far too technical to look up simple things like "how to declare a
> function".
>
> I guess what I'm trying to say is that there is no manual (for the
language
> itself, not the modules).  There is just the tutorial that serves as
the
> manual.  I think it should evolve into a manual that is more
comprehensive
> and organized more like other programming manuals (chapter on control
> structures, functions, classes, inheritance, etc).

Fair enough. An 'upgraded' tutorial that would include simple
discussion on some 'advanced topics' could be helpful. For example,
there is (almost) no reference to the new-style classes inside the
tutorial, the "yield" keyword and generator stuff is described in
half a page, etc. 

SB