procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

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
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 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 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 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 (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 not the user's. The @code{append-to-buffer} function showed how to do