GNU bug report logs - #31683
emacs-lisp-intro.texi - opportunity to link eintr to elisp

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 31683 <at> debbugs.gnu.org
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 <at> scratch.space>
> Date: Sun, 3 Jun 2018 12:11:48 +1000
> Cc: 31683 <at> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.