mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-21 06:55:39 +00:00
Code Issues Releases Activity

Add more text to clarify the behavior of 'with-current-buffer'

Browse Source 
* doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Expand
description of 'with-current-buffer'.  (Bug#67521)

Copyright-paperwork-exempt: yes
This commit is contained in:
Xiyue Deng 2023-11-28 17:44:31 -08:00 committed by Eli Zaretskii
parent 687c416ce9
commit c46700deb0
1 changed files with 5 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -5445,7 +5445,11 @@ That expression starts with @code{get-buffer-create buffer}. The
function tells the computer to use the buffer with the name specified
as the one to which you are copying, or if such a buffer does not
exist, to create it. Then, the @code{with-current-buffer} function
evaluates its body with that buffer temporarily current.
evaluates its body with that buffer temporarily current, after which
it will switch back to the buffer we are at now@footnote{It is like
calling @code{(save-excursion (set-buffer ...) ...)} in one go, though
it is defined slightly differently which interested reader can find
out using @code{describe-function}}.
(This demonstrates another way to shift the computer's attention but
not the user's. The @code{append-to-buffer} function showed how to do