mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-27 07:37:33 +00:00
Code Issues Releases Activity

More fixes of Intro to Emacs Lisp

Browse Source 
* doc/lispintro/emacs-lisp-intro.texi (Finding More): Tell the
reader how to invoke 'M-.' without a tags table.  Add a
cross-reference to the Emacs manual for when a tags table does
need to be created.
(append save-excursion): Rephrase a confusing sentence.
(Bug#31578)
This commit is contained in:
Eli Zaretskii 2018-05-24 20:37:15 +03:00
parent c57c226839
commit 4bb2741b7e
1 changed files with 15 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/lispintro/emacs-lisp-intro.texi
View File

@ -4626,16 +4626,25 @@ file, you can use the @code{xref-find-definitions} function to jump to
it. @code{xref-find-definitions} works with a wide variety of
languages, not just Lisp, and C, and it works with non-programming
text as well. For example, @code{xref-find-definitions} will jump to
the various nodes in the Texinfo source file of this document.
the various nodes in the Texinfo source file of this document
(provided that you've run the @command{etags} utility to record all
the nodes in the manuals that come with Emacs; @pxref{Create tags
Table,,, emacs, The GNU Emacs Manual}).
To use the @code{xref-find-definitions} command, type @kbd{M-.}
(i.e., press the period key while holding down the @key{META} key, or
else type the @key{ESC} key and then type the period key), and then,
at the prompt, type in the name of the function whose source code you
want to see, such as @code{mark-whole-buffer}, and then type
@key{RET}. Emacs will switch buffers and display the source code for
the function on your screen. To switch back to your current buffer,
type @kbd{C-x b @key{RET}}. (On some keyboards, the @key{META} key is
@key{RET}. (If the command doesn't prompt, invoke it with an
argument: @kbd{C-u M-.}; @pxref{Interactive Options}.) Emacs will
switch buffers and display the source code for the function on your
screen@footnote{
If instead of showing the source code for a Lisp function, Emacs asks
you which tags table to visit, invoke @kbd{M-.} from a buffer whose
major mode is Emacs Lisp or Lisp Interaction.
}. To switch back to your current buffer, type @kbd{M-,} or
@kbd{C-x b @key{RET}}. (On some keyboards, the @key{META} key is
labeled @key{ALT}.)
@cindex Library, as term for ``file''
@ -5307,8 +5316,8 @@ in GNU Emacs 22
The @code{append-to-buffer} function definition inserts text from the
buffer in which you are currently to a named buffer. It happens that
@code{insert-buffer-substring} copies text from another buffer to the
current buffer, just the reverse---that is why the
@code{insert-buffer-substring} does just the reverse---it copies text
from another buffer to the current buffer---that is why the
@code{append-to-buffer} definition starts out with a @code{let} that
binds the local symbol @code{oldbuf} to the value returned by
@code{current-buffer}.