From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Xiyue Deng Newsgroups: gmane.emacs.bugs Subject: bug#67521: 29.1; Describe with-current-buffer in more details Date: Wed, 29 Nov 2023 22:18:24 -0800 Message-ID: <87plzrbw7j.fsf@debian-hx90.lan> References: <87y1ehavq1.fsf@debian-hx90.lan> <83msuw7lqj.fsf@gnu.org> <87ttp4bj9t.fsf@debian-hx90.lan> <83wmtz6b65.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16899"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 67521-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Nov 30 07:19:13 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1r8aOG-0004AV-Ki for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 30 Nov 2023 07:19:12 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r8aO2-0005Xl-Hh; Thu, 30 Nov 2023 01:18:58 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r8aO0-0005XQ-6j for bug-gnu-emacs@gnu.org; Thu, 30 Nov 2023 01:18:57 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1r8aNz-00083N-TK for bug-gnu-emacs@gnu.org; Thu, 30 Nov 2023 01:18:55 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1r8aO6-0004lT-Gg for bug-gnu-emacs@gnu.org; Thu, 30 Nov 2023 01:19:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Xiyue Deng Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 30 Nov 2023 06:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 67521 X-GNU-PR-Package: emacs Original-Received: via spool by 67521-done@debbugs.gnu.org id=D67521.170132512318285 (code D ref 67521); Thu, 30 Nov 2023 06:19:02 +0000 Original-Received: (at 67521-done) by debbugs.gnu.org; 30 Nov 2023 06:18:43 +0000 Original-Received: from localhost ([127.0.0.1]:52054 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r8aNn-0004kr-Gi for submit@debbugs.gnu.org; Thu, 30 Nov 2023 01:18:43 -0500 Original-Received: from mail-pg1-x532.google.com ([2607:f8b0:4864:20::532]:54517) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r8aNk-0004kV-Mw for 67521-done@debbugs.gnu.org; Thu, 30 Nov 2023 01:18:41 -0500 Original-Received: by mail-pg1-x532.google.com with SMTP id 41be03b00d2f7-5c206572eedso505577a12.0 for <67521-done@debbugs.gnu.org>; Wed, 29 Nov 2023 22:18:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1701325106; x=1701929906; darn=debbugs.gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=ON52FzD/h8FgRx+87ZCgS5FKGU5RTwZEWb4zriMiTxw=; b=cwqb6/ma6kcsYTSfuDT5lfz1L9Esm+tiu7jA3XDALYSDS6KYzpamQkKgFbOw/1ZGLp qzDqSWm2em3U17eU2/uLhZ7A0lfLrwiN1JDEvGRTm/B+xJuwBBgiCllfZrzTruuM4Vas FyuMQrfbjfrtUZ/PNGaRBco0kjuTNoNRFQTt392vuwr6TXqU8KYK39+LoBLNx4OEdtRg FOpADgQUUu+JkmaiZ7P4g4/nfb+fYmvGpIVAHVX+zWLxW/j36aBbrmM8W3pTvE9J7CFe LvK8AjRGQ94g+DhWtbXkArKqmfAt72UsTv+W48u4Cm6Mza7Q2rsUlNyuiJ53Md8AQDTP ZCGw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1701325106; x=1701929906; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=ON52FzD/h8FgRx+87ZCgS5FKGU5RTwZEWb4zriMiTxw=; b=jk5eg/0mzh4lPC8Y2oNtCAcgDoiwoZ2F6Xhwwus3hjMB0dejhtC+R9DajA4wJnmdxy o61j6ITMN4F+ZW+hcEEtInGbK1aGev+xrwZQ3zhCcshxFbcMh7oOAM8K1Ixkq/WBNoV1 x65Ur8LkSpMDarLzYTcngeZ1eICL8YgPsAkvprrAZaLkVlKDoutGd2ZrdnlvPGtp+mQt MWQgPff7tU7SO+wcRboGUS7XJ7rTVdptshjJa2plAdY8IpmlmOWIkNuV2kwhS9X3ugG0 kTrupRor0dfKoRCCFChKQBlhue5ZomN0PUofTitcU2qg4Kg/evfBbhSDJz1MKTFuwbLI lVig== X-Gm-Message-State: AOJu0YxmnLsHqForrav2u9bKWoBz1i3+QZ+dGgn50B+aq5nmwW0IAWgy kiO5/Q6pxnLATEykHPS/ANQLjdS1M0Y= X-Google-Smtp-Source: AGHT+IG6foheHfNdzgGsKjSfqtO13H+QSZaamZKRb9qbgo6FrE+nBzTftWnzFeNTZvA/WAMYMghr9w== X-Received: by 2002:a05:6a20:258c:b0:18b:fc33:a617 with SMTP id k12-20020a056a20258c00b0018bfc33a617mr24924748pzd.1.1701325106418; Wed, 29 Nov 2023 22:18:26 -0800 (PST) Original-Received: from debian-hx90 (2603-8000-a400-0cdc-2f66-a6c8-60e9-f687.res6.spectrum.com. [2603:8000:a400:cdc:2f66:a6c8:60e9:f687]) by smtp.gmail.com with ESMTPSA id 8-20020a17090a01c800b0028590a7b3c5sm521209pjd.37.2023.11.29.22.18.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Nov 2023 22:18:26 -0800 (PST) In-Reply-To: <83wmtz6b65.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 30 Nov 2023 07:51:46 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:275268 Archived-At: Eli Zaretskii writes: >> From: Xiyue Deng >> Cc: 67521-done@debbugs.gnu.org >> Date: Wed, 29 Nov 2023 08:45:34 -0800 >> >> Eli Zaretskii writes: >> >> >> From: Xiyue Deng >> >> 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. >> >> Thanks Eli! Just wondering will this be installed on master also (with >> your fix of course)? > > The release branch is periodically merged onto master, so yes, it > will, in a few days. Ah didn't know that. Thanks for clarifying! -- Xiyue Deng