From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stephen Berman Newsgroups: gmane.emacs.bugs Subject: bug#30001: 27.0.50; Outdated info on save-excursion in (info "(cl) Modify Macros") Date: Sat, 06 Jan 2018 13:12:37 +0100 Message-ID: <87r2r3rxsa.fsf@gmx.net> References: <83efn39wuv.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1515240681 8508 195.159.176.226 (6 Jan 2018 12:11:21 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 6 Jan 2018 12:11:21 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Xu Chunyang , 30001@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jan 06 13:11:17 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eXnJa-0001G1-Q4 for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Jan 2018 13:11:06 +0100 Original-Received: from localhost ([::1]:33324 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eXnLY-000650-FK for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Jan 2018 07:13:08 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39708) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eXnLS-00064c-Me for bug-gnu-emacs@gnu.org; Sat, 06 Jan 2018 07:13:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eXnLR-0002WT-SJ for bug-gnu-emacs@gnu.org; Sat, 06 Jan 2018 07:13:02 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:57156) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eXnLR-0002WD-OZ for bug-gnu-emacs@gnu.org; Sat, 06 Jan 2018 07:13:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eXnLR-0005n8-IZ for bug-gnu-emacs@gnu.org; Sat, 06 Jan 2018 07:13:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stephen Berman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Jan 2018 12:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30001 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 30001-submit@debbugs.gnu.org id=B30001.151524077722253 (code B ref 30001); Sat, 06 Jan 2018 12:13:01 +0000 Original-Received: (at 30001) by debbugs.gnu.org; 6 Jan 2018 12:12:57 +0000 Original-Received: from localhost ([127.0.0.1]:37604 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eXnLL-0005mo-HN for submit@debbugs.gnu.org; Sat, 06 Jan 2018 07:12:57 -0500 Original-Received: from mout.gmx.net ([212.227.15.18]:51237) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eXnLJ-0005mb-CR for 30001@debbugs.gnu.org; Sat, 06 Jan 2018 07:12:53 -0500 Original-Received: from rosalinde ([83.135.27.230]) by mail.gmx.com (mrgmx002 [212.227.17.190]) with ESMTPSA (Nemesis) id 0MbPPQ-1eHMPr0BXQ-00Ijiy; Sat, 06 Jan 2018 13:12:39 +0100 In-Reply-To: <83efn39wuv.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 06 Jan 2018 11:10:00 +0200") X-Provags-ID: V03:K0:E7QhGYR5ytoBxl0H4JcpF5Y9Iczd1G7CM1F93gRCMiNowDj58Yi ClEoGXl/f3voWwMvUlzWITxSqudtkjjAUEim0o7LYXKiW5CPVqLnsAklqpemG6bPwtbu9vT E5/y/g+swllhDA96/I/SV+Uufdm885BtaJ45dSzqVoACbTyGovclCx1m3LRe3/NuoziEtrU ZgD0X0F9YtfaKsRz7wYyA== X-UI-Out-Filterresults: notjunk:1;V01:K0:5npcRrsx8TQ=:mP+WhIUdaYPMikAHKre4fl rVgEJzPfy2z3kXPNqsglkJ8vtaF8xCi8aM6vi0QONRAhTwO/lBuFxs7SkMAqzHRxFIFO9KoC0 0eFIX31G+KcZWXnXPj+HaGe8YJzqv7H1jBxXY/z9oE+g0BOBJevDTwl4BzqbOF2r6kj8lqPh2 3FYCYTzugUQKR120Iwfa72joSRvdRi00h6aeLPvFlgFQqFK44serTWmF90jhYrGANNlFObNZW VXB4SJ+lpXODiac0t7Jy0fjphwl0hLMNKfmMuCNjYOHvKlPyN+0G4dOn6+yDP9VsFC5Y1J/Ml FhxnLwg8ppJtXk/2Fvjlj4P4vnzlA8iDeHwXiAICPaZ4rPIx9NDEi+m+0EMt+MyUZdzKBQ7cp SeaW6zTOZtzU1jdNWoDB9vsoyKW6UKlJyNLmYIBfyXFyigSw4H51icCfnJeaqx8/bieXmDqui 5kc2e4XWi1Bsy+wXQ0kC1HO3CDotj7xm5tpk6yHFEgws8oD7hEefQaZvtYMl/gwM5Oi6gUVhE so2vtwfyGxbAvY39dE9ynkIcUmW25huuQwzSZFuHIPE84Tv7XsCXa5gYRd9nc6SmwoeIztZjo Wp5nO2LsbL8s9qP44/x1BbAC213MibxW2G4E/dVElOqC56AIN9tuIGkmAFDTUL9GF/eyDqQRR eM9oq0P5AzRvT3/M84FjHm9Xl33LL7Onlq7ALQOaPuRpgc5zXDVLJzvGwTNjfXOepAIvD9/CH Fri+1P4pSFNce8/dpulocgpO2wZ73ode3U75xdscrWe2SQtuJtZ+0dLadjm9Ey0cA04CUqNm X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:141830 Archived-At: On Sat, 06 Jan 2018 11:10:00 +0200 Eli Zaretskii wrote: >> From: Xu Chunyang >> Date: Sat, 06 Jan 2018 13:29:57 +0800 >>=20 >> 'C-h S cl-letf' or (info "(cl) Modify Macros") has the following: >>=20 >> Note that `cl-letf' on `(point)' is not quite like a >> `save-excursion', as the latter effectively saves a marker which >> tracks insertions and deletions in the buffer. >>=20 >> but 'save-excursion' is no longer saving marker since Emacs 25.1 >> according to 'C-h f save-excursion'. > > save-excursion doesn't save the _mark_, but it still saves a _marker_ > that tracks point, as opposed to just the value of point at the moment > of the call. It looks like the doc string of save-excursion contains a few typos: Before Emacs 25.1, =E2=80=98save-excursion=E2=80=99 used to save the mark= state. To save the marker state as well as the point and buffer, use ^^^^^^ ^^^ ^^^^^^ =E2=80=98save-mark-and-excursion=E2=80=99. Shouldn't that be: "To save the mark state as well as point and the buffer"? Steve Berman