From adf5973940e99e7ec676e2f5d43aae9026075f43 Mon Sep 17 00:00:00 2001 From: Xiyue Deng Date: Tue, 28 Nov 2023 17:44:31 -0800 Subject: [PATCH] Add more text to clarify the behavior of with-current-buffer * doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): update text --- doc/lispintro/emacs-lisp-intro.texi | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) 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 -- 2.39.2