[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Imports / inclusion of s.el into Emacs

From: Eli Zaretskii
Subject: Re: Imports / inclusion of s.el into Emacs
Date: Sun, 03 May 2020 19:51:36 +0300

> From: Yuri Khan <address@hidden>
> Date: Sun, 3 May 2020 23:32:01 +0700
> Cc: Philippe Vaucher <address@hidden>, Dmitry Gutov <address@hidden>, 
>       Richard Stallman <address@hidden>, João Távora <address@hidden>, 
>       Stefan Monnier <address@hidden>, Emacs developers <address@hidden>
> On Sun, 3 May 2020 at 23:13, Eli Zaretskii <address@hidden> wrote:
> > Tutorials are generally read only once,
> > when you first familiarize yourself with a topic and generally want
> > just the "taste" of it.  Once you are past that step, there's no
> > reason to go back to the tutorial, and the reference manual is the
> > main tool for learning and doing.
> >
> > And yet you insist on seeing "tutorial-style" lists each time you need
> > some API, but don't really know which.  Why? this doesn't sound like
> > what people use tutorials for.
> API lists are not tutorials.

Are you saying this to me or to Philippe?  It was him who brought up
the tutorial analogy.  I just responded to that.

> They are the reference manual, just presented in a very condensed
> form. A user who is moderately experienced with an API but has not
> committed it into memory will sometimes forget exact names of
> functions, and a concise API list will refresh his/her memory just
> enough to continue coding.

We've been there, let's not make another round of the same arguments.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]