>
> I understand this very well, I'm just astonished to hear that this is
> all the documentation you and some others want to see or have.  It's
> completely against all I have ever learned and practiced in the way of
> teaching people various skills and topics (and I did that more than
> once or twice).
>

No this is not what we are saying. Tutorials are not the only documentation
I and others want to see.

We like to switch between tutorials and full-blown documentation at
different times depending on various factors. In Emacs there's only the
full-blown documentation.



> Emacs has a wealth of documentation at your fingertips, arranged,
> indexed, and enriched with a large collection of commands designed to
> make our self-documenting editor easy to study.  To give up all of
> this and insist on having instead a flat list of APIs that match some
> textual pattern is something that comes as a shock to me.
>

We are not giving up on it. Some might but at least not me.

Philippe