Documentation suggestions

[Fredrik Lundh]

Ian Bicking wrote:

> > the standard library is not an add-on.  you're confused.
>
> I think the point is that there is the core language, and from a user's
> perspective builtins and statements and syntax are all the same thing.
> When you import a module, it's more-or-less obvious where you find
> information about the module (the module index, of course).  But
> "print", "sorted", and "list" are all equally "built in" in the mind of
> a new user.

so are many standard modules (don't tell me that any real user will
learn all the builtins before she writes her first import statement...)

> A new and improved language reference document should deal with all of
> these together, I think.

wasn't the idea to get rid of the language reference altogether, and
replace it with a better introduction ?

</F>