From: Glenn Morris <rgm@gnu.org>
Date: Fri, 20 Feb 2015 05:42:22 +0000 (-0800)
Subject: * src/fileio.c (Fmake_temp_name): Doc tweaks.
X-Git-Tag: emacs-24.4.91~15
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=35f047c;p=emacs.git

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

Fixes: debbugs:19858
---

diff --git a/src/ChangeLog b/src/ChangeLog
index 52be915ecb9..8bffdadf66c 100644
--- 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 fb1fe28aca2..c87a87ca7c6 100644
--- 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);