[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#31683: emacs-lisp-intro.texi - opportunity to link eintr to elisp
From: |
Eli Zaretskii |
Subject: |
bug#31683: emacs-lisp-intro.texi - opportunity to link eintr to elisp |
Date: |
Sun, 03 Jun 2018 18:19:07 +0300 |
> From: Van L <van@scratch.space>
> Date: Sun, 3 Jun 2018 12:11:48 +1000
> Cc: 31683@debbugs.gnu.org
>
>
> > Eli Zaretskii writes:
> >
> > Which is actually related to the second location you mentioned
>
> Which was the summary section.
Right.
> > In general, this manual is not an introduction chapter for the ELisp
> > manual
>
> The impression given in other discussion about this was the intention for
> eintr to be close and interwoven with elisp at a level of detail that bends
> over backwards for a ,non-programmer'.
>
> There are in general two kinds of people.
>
> One digests the elisp. Straight away.
>
> The other prefers eintr at first.
>
> Having tips of the elisp in the eintr is consciousness raising and invites
> the reader to go far one day.
I'm not saying there should be no cross-references to ELisp -- we
already have quite a few. I'm saying that having a cross-reference in
every place where we could possibly place one is not TRT for this
manual, because it is not a reference manual.