; Improve documentation of 'make-temp-file'

* doc/lispref/files.texi (Unique File Names):
* lisp/files.el (make-temp-file):
* src/fileio.c (Fmake_temp_file_internal): Doc fixes.

doc/lispref/files.texi

@@ -2777,6 +2777,9 @@ the end of the file name.
 
 If @var{text} is a string, @code{make-temp-file} inserts it in the file.
 
+On Posix systems, Emacs creates the file with permissions that limit its
+access to the current user.
+
 To prevent conflicts among different libraries running in the same
 Emacs, each Lisp program that uses @code{make-temp-file} should have its
 own @var{prefix}.  The number added to the end of @var{prefix}

lisp/files.el

@@ -1790,7 +1790,10 @@ If DIR-FLAG is non-nil, create a new empty directory instead of a file.
 If SUFFIX is non-nil, add that at the end of the file name.
 
 If TEXT is a string, insert it into the new file; DIR-FLAG should be nil.
-Otherwise the file will be empty."
+Otherwise the file will be empty.
+
+On Posix systems, the file/directory is created with access mode bits
+that limit access to the current user."
   (let ((absolute-prefix
 	 (if (or (zerop (length prefix)) (member prefix '("." "..")))
 	     (concat (file-name-as-directory temporary-file-directory) prefix)

src/fileio.c

@@ -774,6 +774,9 @@ Do not expand PREFIX; a non-absolute PREFIX is relative to the Emacs
 working directory.  If TEXT is a string, insert it into the newly
 created file.
 
+On Posix systems, the file/directory is created with access mode bits
+that limit access to the current user.
+
 Signal an error if the file could not be created.
 
 This function does not grok magic file names.  */)