all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Xiyue Deng <manphiz@gmail.com>
Cc: 67521-done@debbugs.gnu.org
Subject: bug#67521: 29.1; Describe with-current-buffer in more details
Date: Wed, 29 Nov 2023 15:05:56 +0200	[thread overview]
Message-ID: <83msuw7lqj.fsf@gnu.org> (raw)
In-Reply-To: <87y1ehavq1.fsf@debian-hx90.lan> (message from Xiyue Deng on Tue,  28 Nov 2023 23:01:58 -0800)

> From: Xiyue Deng <manphiz@gmail.com>
> Date: Tue, 28 Nov 2023 23:01:58 -0800
> 
> In section 5.1, "The Definition of `copy-to-buffer'" of "Introduction to
> Emacs Lisp", when describing the implementation, the description of
> function `with-current-buffer' is a little too succinct with a sentence
> "Then, the `with-current-buffer 'function evaluates its body with that
> buffer temporarily current." and another one in the parentheses
> "`with-current-buffer' is a newer, and arguably easier, mechanism."
> 
> AIUI the intro book is intended for people without programming
> experience.  While arguably these two sentences do describe the
> `with-current-buffer' function, it would be better to expand a little
> more on what it does after "with that buffer temporarily current", such
> as it will switch back to the current buffer upon finishing the inner
> operations, etc.
> 
> Below is a proposed patch to expand the description a little.  Thanks in
> advance for considering!

Thanks, installed on the emacs-29 branch, and closing the issue.





  reply	other threads:[~2023-11-29 13:05 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-11-29  7:01 bug#67521: 29.1; Describe with-current-buffer in more details Xiyue Deng
2023-11-29 13:05 ` Eli Zaretskii [this message]
2023-11-29 16:45   ` Xiyue Deng
2023-11-30  5:51     ` Eli Zaretskii
2023-11-30  6:18       ` Xiyue Deng

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=83msuw7lqj.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=67521-done@debbugs.gnu.org \
    --cc=manphiz@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.