Subject: bug#30001: 27.0.50; Outdated info on save-excursion in (info "(cl) Modify Macros")

From: Stephen Berman <[email-masked]>
Date: Sat, 06 Jan 2018 13:12:37 +0100

On Sat, 06 Jan 2018 11:10:00 +0200 Eli Zaretskii <[email-masked]> wrote:

>> From: Xu Chunyang <[email-masked]>
>> Date: Sat, 06 Jan 2018 13:29:57 +0800
>> 
>> 'C-h S cl-letf' or (info "(cl) Modify Macros") has the following:
>> 
>>   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.
>> 
>> 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, ‘save-excursion’ used to save the mark state.
  To save the marker state as well as the point and buffer, use
              ^^^^^^                  ^^^           ^^^^^^
  ‘save-mark-and-excursion’.

Shouldn't that be: "To save the mark state as well as point and the
buffer"?

Steve Berman