From 6b4bafedbc76ea32228e27d94eeee8da25bf91f0 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 18 May 2018 09:31:24 +0300 Subject: [PATCH 1/2] ; 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 ebc4c7f009b..1a3081ca9f0 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 +@c If you think this manual is too large for an introduction, please +@c consider this email exchange: +@c +@c >> The intro is almost 300 pages in full. I had expected 60 pages. +@c > +@c > This is an important point in its own right. Could you +@c > write a simplified introduction that is only 50 pages or so? +@c > That would be helpful to many potential users, I'd think. +@c +@c > The problem with the introduction is that it was written when +@c > programming was only starting to be a skill "normal" people could +@c > have access to. So the text is extremely verbose and is +@c > sometimes hard to follow because of that. The gist of the +@c > document could be summarized in 50 pages. +@c +@c This book is intentionally addressed to people who don't know how to +@c program. That is its purpose. We recommend people start learning to +@c program using this book. +@c +@c If you DO know how to program in some other language, you can probably +@c learn Emacs Lisp starting with the Emacs Lisp Reference Manual. +@c +@c Richard Stallman , +@c https://lists.gnu.org/archive/html/emacs-devel/2018-05/msg00374.html + @shortcontents @contents From 73bc6f8693fcbb98b41ee67ab35a4dd8c3940355 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 18 May 2018 10:58:11 +0300 Subject: [PATCH 2/2] Fix a typo in describing input methods * lisp/help-mode.el (help-make-xrefs): Fix a typo. (Bug#31448) --- lisp/help-mode.el | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lisp/help-mode.el b/lisp/help-mode.el index 68fc319e68c..a13494aa460 100644 --- a/lisp/help-mode.el +++ b/lisp/help-mode.el @@ -474,7 +474,7 @@ that." (and sym (charsetp sym) (help-xref-button 7 'help-character-set sym))) ((assoc data input-method-alist) - (help-xref-button 7 'help-character-set data)) + (help-xref-button 7 'help-input-method data)) ((and sym (coding-system-p sym)) (help-xref-button 7 'help-coding-system sym)) ((and sym (charsetp sym))