From b63e2b17063b770287357b30d1839c8df4e7eeb1 Mon Sep 17 00:00:00 2001 From: dkf Date: Thu, 1 Nov 2007 10:08:39 +0000 Subject: Clarified [file nativename] usage. [Bug 1185154] --- ChangeLog | 4 ++++ doc/file.n | 15 ++++++++++++--- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 5a414e5..a19a492 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2007-11-01 Donal K. Fellows + + * doc/file.n: Clarified use of [file normalize]. [Bug 1185154] + 2007-10-30 Don Porter * generic/tcl.h: Bump version number to 8.5b2.1 to distinguish diff --git a/doc/file.n b/doc/file.n index 3a02c5a..b3243df 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.51 2007/10/30 23:50:54 dkf Exp $ +'\" RCS: @(#) $Id: file.n,v 1.52 2007/11/01 10:08:41 dkf Exp $ '\" .so man.macros .TH file n 8.3 Tcl "Tcl Built-In Commands" @@ -272,8 +272,8 @@ or set then an error is generated. \fBfile nativename \fIname\fR . Returns the platform-specific name of the file. This is useful if the -filename is needed to pass to a platform-specific call, such as exec -under Windows. +filename is needed to pass to a platform-specific call, such as to a +subprocess via \fBexec\fR under Windows (see \fBEXAMPLES\fR below). .TP \fBfile normalize \fIname\fR . @@ -489,6 +489,15 @@ if {![\fBfile isdirectory\fR [\fBfile dirname\fR $newName]]} { \fBfile rename\fR $oldName $newName \fBfile link\fR \-symbolic $oldName $newName .CE +.PP +On Windows, a file can be +.QW started +easily enough (equivalent to double-clicking on it in the Explorer +interface) but the name passed to the operating system must be in +native format: +.CS +exec {*}[auto_execok start] {} [\fBfile nativename\fR ~/example.txt] +.CE .SH "SEE ALSO" filename(n), open(n), close(n), eof(n), gets(n), tell(n), seek(n), fblocked(n), flush(n) -- cgit v0.12