Re: Imports / inclusion of s.el into Emacs

[Eli Zaretskii]

> From: Philippe Vaucher <address@hidden>
> Date: Sat, 2 May 2020 21:54:42 +0200
> Cc: João Távora <address@hidden>, 
>       Emacs developers <address@hidden>, Stefan Monnier <address@hidden>, 
>       Richard Stallman <address@hidden>, Dmitry Gutov <address@hidden>
> 
> Maybe you are just unfamiliar with the "tutorial" way of learning things. 

I am familiar with tutorials.  They have their limits: you can only
learn this much by following a tutorial.

The ELisp manual is not a tutorial, it is (or at least is supposed to
be) a complete and comprehensive reference manual to the Emacs Lisp
language and core facilities.

> For quite a lot of people, this page 
> http://ergoemacs.org/emacs/elisp_string_functions.html is much simpler
> to use & learn from than this page
> https://www.gnu.org/software/emacs/manual/html_node/elisp/Strings-and-Characters.html
> 
> It does not mean that the later page is bad, it is actually more complete, 
> better documented, already grouped
> in topics... and yet, a lot of people prefer the first page... straight to 
> the point, simple examples.
> 
> Please tell me if you are able to understand this, if you cannot I'll try to 
> explain further.

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).

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.