[gnu.emacs.bug] kill-all-local-variables documentation

drw@BOURBAKI.MIT.EDU (08/24/89)

The documentation for kill-all-local-variables should note that not
only does it kill all local variables, but also certain other
buffer-specific information:  the major mode is reset to fundamental
mode, the local keymap is nulled, the abbrev-table is set to the
fundamental-mode-abbrev-table, the minor modes are cleared, and the
syntax-table is reset set to standard-syntax-table.

In fact, you could express the intent of the function by saying that
it resets ALL buffer specific properties other than its contents,
default directory and visited file name.  (And perhaps other
things???)  In fact, maybe it should have a different name.

I'm not complaining that these are done, but PLEASE! document it.
I've just spent several hours discovering why my local-mode map gets
clobbered.

Dale