M-x compile re-uses name of old compilation buffer, contrary to documentation

[Edward Welbourne <eddy@opera.com>]

I opened the top-level directory of a source tree, to make it current directory.
M-x compile
added cvs up; to start of make command-line, hit return
Killed directory buffer.  Switched to *compilation* and did
M-x rename-buffer
Supplied name *myprog update build*, left it to finish building.
After it'd finished I fixed a compile error and, with cursor in *myprog update build*, did
M-x compile
removed the cvs up; from the command-line, hit return.

The new compilation re-used *myprog update build* as its buffer,
instead of creating a new buffer called *compilation* as clearly
explained in the documentation for M-x compile, specifically when
explaining how to avoid conflict between compilations (albeit ones
running in parallel).

The problem with this is that I actually wanted to keep the ouptut
from the original build - it recorded what files I've got locally
changed, and contained compiler warnings that I wanted to fix !  I now
have to do another cvs up to recover the list of local changes; and
I'll need to make clean and make in order to recover the list of
warnings.

compilation-buffer-name-function is nil

This is probably just a documentation bug.
I can see the given behaviour might even be intended, it's just not
what I'm used to, so it caught me out.


In GNU Emacs 22.1.1 (i486-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2007-07-07 on raven, modified by Debian
Windowing system distributor `The X.Org Foundation', version 11.0.10300000
configured using `configure  '--build=i486-linux-gnu' '--host=i486-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var/lib' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs22:/etc/emacs:/usr/local/share/emacs/22.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/22.1/site-lisp:/usr/share/emacs/site-lisp:/usr/share/emacs/22.1/leim' '--with-x=yes' '--with-x-toolkit=athena' '--with-toolkit-scroll-bars' 'build_alias=i486-linux-gnu' 'host_alias=i486-linux-gnu' 'CFLAGS=-DDEBIAN -g -O2''

Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: en_GB.ISO-8859-15
  locale-coding-system: iso-8859-15
  default-enable-multibyte-characters: t

Major mode: Lisp Interaction

Minor modes in effect:
  tooltip-mode: t
  mouse-wheel-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  unify-8859-on-encoding-mode: t
  utf-translate-cjk-mode: t
  auto-compression-mode: t
  line-number-mode: t

Recent input:
C-e C-p M-b M-b M-b M-b C-SPC M-f M-f M-f M-f M-w C-x 
o C-x o C-h C-g C-x C-x M-w C-h v C-y <return> q C-x 
3 C-x k <return> M-x c o m p i l e <return> C-a M-f 
M-f M-f M-f M-f M-b <M-backspace> <M-backspace> <M-backspace> 
<M-backspace> <return> M-< C-x o q C-x k <return> C-x 
b * m a i <tab> <return> M-{ M-{ M-{ C-n M-> M-{ C-x 
C-x C-w C-b M-b a g a i n SPC C-n <return> a l s o 
: SPC w h a t SPC i s SPC t h e SPC b e n f <backspace> 
e f i t SPC f SPC <backspace> <backspace> o f SPC a 
d d i n g SPC a n SPC e l s e SPC t o SPC t h e s e 
SPC f u n c t i o n s SPC ? C-n M-> C-c C-c C-x o C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-p C-p C-p 
C-p C-p C-p C-p C-p C-x C-f a d j <tab> <return> M-! 
c v s SPC u p SPC - r SPC p e r e g r i n e <return> 
C-x k <return> C-x C-f <backspace> <return> M-x c o 
m p i l e <return> <return> C-x k <return> C-x o M-x 
M-p <return> <return> C-x o C-x k <return> C-x o C-x 
o M-x e m a <tab> b u <tab> <M-backspace> r e p <tab> 
<M-backspace> <M-backspace> b u <tab> g <tab> <M-backspace> 
r e p <tab> o <tab> r <tab> <return>

Recent messages:
(No changes need to be saved)
Mark set [2 times]
Sending...done
? quick/setup/munge
P m2/src/import/EudoraImporter.cpp
M quick/quick-tweaks.h
M quick/windows/DocumentDesktopWindow.cpp
(No files need saving) [2 times]
Making completion list... [3 times]
Loading emacsbug...done