* src/fileio.c (Fmake_temp_name): Doc tweaks.

Fixes: debbugs:19858

diff --git a/src/ChangeLog b/src/ChangeLog
index 52be915ecb97cb5f0dadac5349f6250ff071022c..8bffdadf66c91b48ab7d82a2270fe592c495f73d 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,7 @@
+2015-02-20  Glenn Morris  <rgm@gnu.org>
+
+       * fileio.c (Fmake_temp_name): Doc tweaks.  (Bug#19858)
+
 2015-02-14  Eli Zaretskii  <eliz@gnu.org>
 
        * menu.c (Fx_popup_menu) [HAVE_X_WINDOWS]: Call

diff --git a/src/fileio.c b/src/fileio.c
index fb1fe28aca2f0970974badccb208bf8b192fc586..c87a87ca7c6431f33c696b678c96bc4f372ae1db 100644 (file)
--- a/src/fileio.c
+++ b/src/fileio.c
@@ -828,20 +828,16 @@ make_temp_name (Lisp_Object prefix, bool base64_p)
 
 DEFUN ("make-temp-name", Fmake_temp_name, Smake_temp_name, 1, 1, 0,
        doc: /* Generate temporary file name (string) starting with PREFIX (a string).
-The Emacs process number forms part of the result,
-so there is no danger of generating a name being used by another process.
+The Emacs process number forms part of the result, so there is no
+danger of generating a name being used by another Emacs process
+\(so long as only a single host can access the containing directory...).
 
-In addition, this function makes an attempt to choose a name
-which has no existing file.  To make this work,
-PREFIX should be an absolute file name.
+This function tries to choose a name that has no existing file.
+For this to work, PREFIX should be an absolute file name.
 
 There is a race condition between calling `make-temp-name' and creating the
-file which opens all kinds of security holes.  For that reason, you should
-probably use `make-temp-file' instead, except in three circumstances:
-
-* If you are creating the file in the user's home directory.
-* If you are creating a directory rather than an ordinary file.
-* If you are taking special precautions as `make-temp-file' does.  */)
+file, which opens all kinds of security holes.  For that reason, you should
+normally use `make-temp-file' instead.  */)
   (Lisp_Object prefix)
 {
   return make_temp_name (prefix, 0);