`delete-auto-save-files' docstring inaccurate?

[Samuel Padgett]

This bug report will be sent to the Free Software Foundation,
not to your local site managers!
Please write in English, because the Emacs maintainers do not have
translators to read other languages for them.

Your bug report will be posted to the bug-gnu-emacs@gnu.org mailing list,
and to the gnu.emacs.bug news group.

In GNU Emacs 21.1.1 (i686-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2001-10-30 on harpo.homeip.net
Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: en_US
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: C
  locale-coding-system: iso-latin-1
  default-enable-multibyte-characters: t

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:

[ I apologize if this is a duplicate report.  I had trouble sending
  the first one. ]

If I look at the docstring for `delete-auto-save-files', it says:

    delete-auto-save-files's value is t

    Documentation:
    *Non-nil means delete auto-save file when a buffer is saved or killed.

    Note that auto-save file will not be deleted if the buffer is killed
    when it has unsaved changes.

This is not the behavior I see, however.  To recreate:

    * Start Emacs "emacs -q --no-site-file".
    * Make sure directory ~/tmp exists.
    * C-x C-f ~/tmp/foo.c RET
    * Type some text into the buffer.
    * M-x do-auto-save RET
    * Examine the ~/tmp directory and notice that file ~/tmp/#foo.c# was
      created.  Also note that the buffer has unsaved changes.
    * Type C-x k RET yes RET to kill the buffer.
    * Examine the ~/tmp directory again.  The auto-save file is gone.

The documentation explicitly states that auto-save files are not
deleted when a buffer with unsaved changes is killed.  Is this a
documentation bug?  Or are the docs right and the auto-save file
shouldn't be deleted?

Thanks,
Sam


Recent input:
ESC x r e p o r t - e m a c s - b u g RET

Recent messages:
Loading ~/.viper...done
Loading /usr/local/libexec/emacs/21.1/i686-pc-linux-gnu/fns-21.1.1.el 
(source)...done

Loading skeleton...done
Loading image...done
Loading /home/sam/.recentf...done
Loading mule-util...done
Loading ~/.emacs.local...done
For information about the GNU Project and its goals, type C-h C-p.
Loading emacsbug...done