[Emacs-diffs] emacs-26 6b4bafe: ; Add a comment to emacs-lisp-intro.texi

[Eli Zaretskii]

branch: emacs-26
commit 6b4bafedbc76ea32228e27d94eeee8da25bf91f0
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    ; Add a comment to emacs-lisp-intro.texi
    
    * doc/lispintro/emacs-lisp-intro.texi: Add a comment with the
    rationale for the manual's seemingly too large size.
---
 doc/lispintro/emacs-lisp-intro.texi | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/doc/lispintro/emacs-lisp-intro.texi 
b/doc/lispintro/emacs-lisp-intro.texi
index ebc4c7f..1a3081c 100644
--- a/doc/lispintro/emacs-lisp-intro.texi
+++ b/doc/lispintro/emacs-lisp-intro.texi
@@ -198,6 +198,31 @@ supports it in developing GNU and promoting software 
freedom.''
 @end ifset
 @end ifnothtml
 
address@hidden If you think this manual is too large for an introduction, please
address@hidden consider this email exchange:
address@hidden
address@hidden       >> The intro is almost 300 pages in full.  I had expected 
60 pages.
address@hidden       >
address@hidden       > This is an important point in its own right.  Could you
address@hidden       > write a simplified introduction that is only 50 pages or 
so?
address@hidden       > That would be helpful to many potential users, I'd think.
address@hidden
address@hidden   > The problem with the introduction is that it was written when
address@hidden   > programming was only starting to be a skill "normal" people 
could
address@hidden   > have access to.  So the text is extremely verbose and is
address@hidden   > sometimes hard to follow because of that.  The gist of the
address@hidden   > document could be summarized in 50 pages.
address@hidden
address@hidden This book is intentionally addressed to people who don't know 
how to
address@hidden program.  That is its purpose.  We recommend people start 
learning to
address@hidden program using this book.
address@hidden
address@hidden If you DO know how to program in some other language, you can 
probably
address@hidden learn Emacs Lisp starting with the Emacs Lisp Reference Manual.
address@hidden
address@hidden        Richard Stallman <address@hidden>,
address@hidden        
https://lists.gnu.org/archive/html/emacs-devel/2018-05/msg00374.html
+
 @shortcontents
 @contents