summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2015-02-19 21:42:22 -0800
committerGlenn Morris <rgm@gnu.org>2015-02-19 21:42:22 -0800
commit35f047c06603ce2e549e43ba38de0e61083b0311 (patch)
treea225d6945a1efcd4dfdba6a33fd7513ba520f7d9
parent6f2971ab761e62e649892bd3fe5c08983420c5ae (diff)
downloademacs-35f047c06603ce2e549e43ba38de0e61083b0311.tar.gz
* src/fileio.c (Fmake_temp_name): Doc tweaks.
Fixes: debbugs:19858
-rw-r--r--src/ChangeLog4
-rw-r--r--src/fileio.c18
2 files changed, 11 insertions, 11 deletions
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);