Re: `save-excursion' defeated by `set-buffer'

[Uday Reddy]

On 3/3/2011 4:58 AM, Le Wang wrote:

> Either the compiler warning or the manual is wrong
> (http://www.gnu.org/software/emacs/elisp/html_node/Current-Buffer.html):
>
>     Therefore, you should normally use |set-buffer| within a
>     |save-current-buffer| or |_save-excursion_| (see Excursions
>     
> <http://www.gnu.org/software/emacs/elisp/html_node/Excursions.html#Excursions>)
>     form that will restore the current buffer when your function is
>     done. Here, as an example, is a simplified version of the command
>     |append-to-buffer|:

That is a fair point.  It seems that this section of the manual hasn't 
been edited for a long time.  I am submitting some changes now.

Notice, however, that the section on save-excursion at

http://www.gnu.org/software/emacs/elisp/html_node/Excursions.html#Excursions
says:

      When only the identity of the current buffer needs to be saved
      and restored, it is preferable to use save-current-buffer instead.

Cheers,
Uday