improved filesystem documentation

1 files changed, 11 insertions, 8 deletions

diff --git a/doc/file.n b/doc/file.n
index ce699aa..0658009 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.25 2003/07/07 08:57:58 vincentdarley Exp $
+'\" RCS: @(#) $Id: file.n,v 1.26 2003/12/12 17:02:13 vincentdarley Exp $
 '\" 
 .so man.macros
 .TH file n 8.3 Tcl "Tcl Built-In Commands"
@@ -220,13 +220,16 @@ error if for some reason that is not possible), then the optional
 \fI-linktype\fR argument should be given.  Accepted values for
 \fI-linktype\fR are "-symbolic" and "-hard".
 .
-When creating links on filesystems that either do not support any links,
-or do not support the specific type requested, an error message will be
-returned.  In particular Windows 95, 98 and ME do not support any links
-at present, but most Unix platforms support both symbolic and hard links
-(the latter for files only), MacOS supports symbolic links and Windows
-NT/2000/XP (on NTFS drives) support symbolic directory links and hard
-file links.
+On Unix, symbolic links can be made to relative paths, but on all other
+platforms target paths will be converted to absolute, normalized form
+before the link is created (and "~user" paths are always expanded to
+absolute form).  When creating links on filesystems that
+either do not support any links, or do not support the specific type
+requested, an error message will be returned.  In particular Windows 95,
+98 and ME do not support any links at present, but most Unix platforms
+support both symbolic and hard links (the latter for files only), MacOS
+supports symbolic links and Windows NT/2000/XP (on NTFS drives) support
+symbolic directory links and hard file links.
 .TP
 \fBfile lstat \fIname varName\fR
 .