doc string of with-temp-file

[Drew Adams]

The doc string of with-temp-file should mention that the new buffer
created is killed at the end.

I tried to do this:

(unwind-protect
    (with-temp-file "foo" (pp something (current-buffer)))
  (kill-buffer "foo"))

If the doc string had been clearer, I would only have done this:

(with-temp-file "foo" (pp something (current-buffer)))

Also (too late to change this, though), the name is not very well
chosen - it gives the impression that a temporary file is involved,
whereas a temporary buffer is involved.


In GNU Emacs 22.0.50.1 (i386-mingw-nt5.1.2600)
 of 2005-06-26 on NONIQPC
X server distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc
(3.3) --cflags -I../../jpeg-6b-3/include -I../../libpng-1.2.8/include -I../.
./tiff-3.6.1-2/include -I../../xpm-nox-4.2.0/include -I../../zlib-1.2.2/incl
ude'