summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2005-04-24 13:24:29 +0000
committerEli Zaretskii <eliz@gnu.org>2005-04-24 13:24:29 +0000
commit5eb20bca14dde4f968cff06e8e40664bc3a7e29f (patch)
tree7117ae938fa9345d2180042fd8171a69c0fb0fe1
parent45d2f8e82c8b00a9c6cb436ee6f99400e474c032 (diff)
downloademacs-5eb20bca14dde4f968cff06e8e40664bc3a7e29f.tar.gz
(Unique File Names): Don't mention "numbers" in the documentation
of make-temp-file and make-temp-name.
-rw-r--r--lispref/ChangeLog2
-rw-r--r--lispref/files.texi25
2 files changed, 16 insertions, 11 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index cdf2ed0da87..fc17818888d 100644
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -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>
diff --git a/lispref/files.texi b/lispref/files.texi
index e7574ec4682..0b6e7a2832d 100644
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -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