mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-09 05:01:02 -08:00
Code Issues Projects Releases Wiki 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
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 it. @code{xref-find-definitions} works with a wide variety of
languages, not just Lisp, and C, and it works with non-programming languages, not just Lisp, and C, and it works with non-programming
text as well. For example, @code{xref-find-definitions} will jump to 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-.} 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 (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, 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 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 want to see, such as @code{mark-whole-buffer}, and then type
@key{RET}. Emacs will switch buffers and display the source code for @key{RET}. (If the command doesn't prompt, invoke it with an
the function on your screen. To switch back to your current buffer, argument: @kbd{C-u M-.}; @pxref{Interactive Options}.) Emacs will
type @kbd{C-x b @key{RET}}. (On some keyboards, the @key{META} key is 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}.) labeled @key{ALT}.)
@cindex Library, as term for ``file'' @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 The @code{append-to-buffer} function definition inserts text from the
buffer in which you are currently to a named buffer. It happens that buffer in which you are currently to a named buffer. It happens that
@code{insert-buffer-substring} copies text from another buffer to the @code{insert-buffer-substring} does just the reverse---it copies text
current buffer, just the reverse---that is why the from another buffer to the current buffer---that is why the
@code{append-to-buffer} definition starts out with a @code{let} that @code{append-to-buffer} definition starts out with a @code{let} that
binds the local symbol @code{oldbuf} to the value returned by binds the local symbol @code{oldbuf} to the value returned by
@code{current-buffer}. @code{current-buffer}.