Document that [file tempfile] always works on the native filesystem by design.

[Bug 2388866]

2 files changed, 17 insertions, 6 deletions

diff --git a/ChangeLog b/ChangeLog
index 7e02bc6..3a34d12 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,12 +1,17 @@
+2009-12-14  Donal K. Fellows  <dkf@users.sf.net>
+
+	* doc/file.n (file tempfile): [Bug 2388866]: Note that this only ever
+	creates files on the native filesystem. This is a design feature.
+
 2009-12-13  Miguel Sofer  <msofer@users.sf.net>
 
-	* generic/tclBasic.c:   Release TclPopCallFrame() from its
-	* generic/tclExecute.c: tailcall-management duties
+	* generic/tclBasic.c:	Release TclPopCallFrame() from its
+	* generic/tclExecute.c:	tailcall-management duties
 	* generic/tclNamesp.c:
 		
-	* generic/tclBasic.c:   Moving TclBCArgumentRelease call 
-	* generic/tclExecute.c: from TclNRTailcallObjCmd to TEBC, so that
-	the pairing of the Enter and Release calls is clearer.
+	* generic/tclBasic.c:	Moving TclBCArgumentRelease call from
+	* generic/tclExecute.c:	TclNRTailcallObjCmd to TEBC, so that the
+	pairing of the Enter and Release calls is clearer.
 
 2009-12-12  Donal K. Fellows  <dkf@users.sf.net>
 
diff --git a/doc/file.n b/doc/file.n
index eb51450..da54c0d 100644
--- a/doc/file.n
+++ b/doc/file.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: file.n,v 1.56 2008/11/29 18:17:19 dkf Exp $
+'\" RCS: @(#) $Id: file.n,v 1.57 2009/12/14 10:03:13 dkf Exp $
 '\" 
 .so man.macros
 .TH file n 8.3 Tcl "Tcl Built-In Commands"
@@ -446,6 +446,12 @@ for the temporary file to be deleted once it is no longer required. If the
 to use when creating it (such as the directory, base-name or extension) though
 some platforms may ignore some or all of these parts and use a built-in
 default instead.
+.RS
+.PP
+Note that temporary files are \fIonly\fR ever created on the native
+filesystem. As such, they can be relied upon to be used with operating-system
+native APIs and external programs that require a filename.
+.RE
 .VE 8.6
 .TP
 \fBfile type \fIname\fR