summaryrefslogtreecommitdiffstats
path: root/doc/file.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/file.n')
-rw-r--r--doc/file.n38
1 files changed, 20 insertions, 18 deletions
diff --git a/doc/file.n b/doc/file.n
index 8332f6d..dfaecbc 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.16 2002/05/08 04:36:54 davygrvy Exp $
+'\" RCS: @(#) $Id: file.n,v 1.17 2002/05/08 12:29:01 davygrvy Exp $
'\"
.so man.macros
.TH file n 8.3 Tcl "Tcl Built-In Commands"
@@ -226,19 +226,21 @@ under Windows or AppleScript on the Macintosh.
.TP
\fBfile normalize \fIname\fR
.
-Returns a unique normalised path representation for the file-system
-object (file, directory, link, etc), whose string value can be used as
-a unique identifier for it. A normalized path is one which has all '../', './'
-removed. Also it is one which is in the ``standard'' format for the native
-platform. On MacOS, Unix, this means the segments leading up to the path
-must be free of symbolic links/aliases (but the very last path component
-may be a symbolic link), and on Windows it also means means we want the
-long form (when running Win NT/2000/XP) or the short form (when running Win
-95/98) with that form's case-dependence (which gives us a unique,
-case-dependent path). The one exception concerning the last link in the
-path is necessary, because Tcl or the user may wish to operate on the
-actual symbolic link itself (for example 'file delete', 'file rename', 'file copy'
-are defined to operate on symbolic links, not on the things that they point to).
+Returns a unique normalised path representation for the file-system
+object (file, directory, link, etc), whose string value can be used as
+a unique identifier for it. A normalized path is one which has all
+'../', './' removed. Also it is one which is in the ``standard''
+format for the native platform. On MacOS, Unix, this means the
+segments leading up to the path must be free of symbolic links/aliases
+(but the very last path component may be a symbolic link), and on
+Windows it also means means we want the long form (when running Win
+NT/2000/XP) or the short form (when running Win 95/98) with that form's
+case-dependence (which gives us a unique, case-dependent path). The
+one exception concerning the last link in the path is necessary,
+because Tcl or the user may wish to operate on the actual symbolic link
+itself (for example 'file delete', 'file rename', 'file copy' are
+defined to operate on symbolic links, not on the things that they point
+to).
.PP
Note that this means normalized paths are different on old Windows
operating systems (95/98) and new Windows operating systems
@@ -353,10 +355,10 @@ the second element may be null. For example the native files have a
first element 'native', and a second element which is a platform-specific
type name for the file's system (e.g. 'NTFS', 'FAT', etc), or possibly
the empty string if no further information is available or if this
-is not implemented. A generic virtual file system might return the
-list 'vfs ftp' to represent a file on a remote ftp site mounted as a
-virtual filesystem through an extension called 'vfs'. If the file does
-not belong to any filesystem, an error is generated.
+is not implemented. A generic virtual file system might return the list
+'vfs ftp' to represent a file on a remote ftp site mounted as a virtual
+filesystem through an extension called 'vfs'. If the file does not
+belong to any filesystem, an error is generated.
.TP
\fBfile tail \fIname\fR
.