diff options
| author | Xiyue Deng <manphiz@gmail.com> | 2023-11-28 17:44:31 -0800 |
|---|---|---|
| committer | Eli Zaretskii <eliz@gnu.org> | 2023-11-29 15:01:20 +0200 |
| commit | c46700deb0aa8750f19e91d050e76c91fff8ce11 (patch) | |
| tree | 516dc56c2ff669bf564f4ed6de65328fcbc5a580 /doc/lispintro/emacs-lisp-intro.texi | |
| parent | 687c416ce9bfba00c771fca859762cee8e1a616b (diff) | |
| download | emacs-c46700deb0aa8750f19e91d050e76c91fff8ce11.tar.gz emacs-c46700deb0aa8750f19e91d050e76c91fff8ce11.tar.bz2 emacs-c46700deb0aa8750f19e91d050e76c91fff8ce11.zip | |
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
Diffstat (limited to 'doc/lispintro/emacs-lisp-intro.texi')
| -rw-r--r-- | doc/lispintro/emacs-lisp-intro.texi | 6 |
1 files changed, 5 insertions, 1 deletions
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 |