From: Xiyue Deng Date: Wed, 29 Nov 2023 01:44:31 +0000 (-0800) Subject: Add more text to clarify the behavior of 'with-current-buffer' X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c46700deb0a;p=emacs.git Add more text to clarify the behavior of 'with-current-buffer' * doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Expand description of 'with-current-buffer'. (Bug#67521) Copyright-paperwork-exempt: yes --- diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index e4a0f585f69..ba93dfd3b91 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -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