]> git.eshelyaron.com Git - emacs.git/commitdiff
(Unique File Names): Don't mention "numbers" in the documentation
authorEli Zaretskii <eliz@gnu.org>
Sun, 24 Apr 2005 13:24:29 +0000 (13:24 +0000)
committerEli Zaretskii <eliz@gnu.org>
Sun, 24 Apr 2005 13:24:29 +0000 (13:24 +0000)
of make-temp-file and make-temp-name.

lispref/ChangeLog
lispref/files.texi

index cdf2ed0da874dba89f220c2a36d41fa5577c8b66..fc17818888d67e8019e75ac17516fdadb9cfca20 100644 (file)
@@ -1,6 +1,8 @@
 2005-04-24  Eli Zaretskii  <eliz@gnu.org>
 
        * files.texi (Changing Files): Fix last change's cross-reference.
+       (Unique File Names): Don't mention "numbers" in the documentation
+       of make-temp-file and make-temp-name.
 
 2005-04-23  Richard M. Stallman  <rms@gnu.org>
 
index e7574ec4682809a0ac4a5ba8c5a92587066ab137..0b6e7a2832da4b64481745fbe4c4872c3a540a9c 100644 (file)
@@ -2028,10 +2028,13 @@ two different jobs from trying to use the exact same file name.
 
 @defun make-temp-file prefix &optional dir-flag suffix
 @tindex make-temp-file
-This function creates a temporary file and returns its name.
-The name starts with @var{prefix}; it also contains a number that is
-different in each Emacs job.  If @var{prefix} is a relative file name,
-it is expanded against @code{temporary-file-directory}.
+This function creates a temporary file and returns its name.  Emacs
+creates the temporary file's name by adding to @var{prefix} some
+random characters that are different in each Emacs job.  The result is
+guaranteed to be a newly created empty file.  On MS-DOS, this function
+can truncate the @var{string} prefix to fit into the 8+3 file-name
+limits.  If @var{prefix} is a relative file name, it is expanded
+against @code{temporary-file-directory}.
 
 @example
 @group
@@ -2076,13 +2079,13 @@ you should use @code{make-temp-name} instead:
 @end example
 
 @defun make-temp-name string
-This function generates a string that can be used as a unique file name.
-The name starts with @var{string}, and contains a number that is
-different in each Emacs job.  It is like @code{make-temp-file} except
-that it just constructs a name, and does not create a file.  Another
-difference is that @var{string} should be an absolute file name.  On
-MS-DOS, this function can truncate the @var{string} prefix to fit into
-the 8+3 file-name limits.
+This function generates a string that can be used as a unique file
+name.  The name starts with @var{string}, and has several random
+characters appended to it, which are different in each Emacs job.  It
+is like @code{make-temp-file} except that it just constructs a name,
+and does not create a file.  Another difference is that @var{string}
+should be an absolute file name.  On MS-DOS, this function can
+truncate the @var{string} prefix to fit into the 8+3 file-name limits.
 @end defun
 
 @defvar temporary-file-directory