From 35f047c06603ce2e549e43ba38de0e61083b0311 Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Thu, 19 Feb 2015 21:42:22 -0800 Subject: [PATCH] * src/fileio.c (Fmake_temp_name): Doc tweaks. Fixes: debbugs:19858 --- src/ChangeLog | 4 ++++ src/fileio.c | 18 +++++++----------- 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 + + * fileio.c (Fmake_temp_name): Doc tweaks. (Bug#19858) + 2015-02-14 Eli Zaretskii * 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); -- 2.39.2