From 56dedeb231281fb437f1caa29d16938b44a41f69 Mon Sep 17 00:00:00 2001 From: dkf Date: Mon, 14 Dec 2009 10:03:12 +0000 Subject: Document that [file tempfile] always works on the native filesystem by design. [Bug 2388866] --- ChangeLog | 15 ++++++++++----- doc/file.n | 8 +++++++- 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 + + * 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 - * 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 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 -- cgit v0.12