From 45113914635bdedbf79a32d3740785576eedf5fe Mon Sep 17 00:00:00 2001 From: davygrvy Date: Wed, 8 May 2002 04:36:54 +0000 Subject: winhelp conversion tools where understand a ' as the first character on a line as an unknown macro. Not knowing how to repair tools/man2tcl.c, I decided to rearrange the text in the docs instead. --- doc/TraceCmd.3 | 4 ++-- doc/file.n | 38 ++++++++++++++++++-------------------- 2 files changed, 20 insertions(+), 22 deletions(-) diff --git a/doc/TraceCmd.3 b/doc/TraceCmd.3 index f39d458..1e640a7 100644 --- a/doc/TraceCmd.3 +++ b/doc/TraceCmd.3 @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" CVS: @(#) $Id: TraceCmd.3,v 1.1 2002/04/23 13:09:51 dkf Exp $ +'\" CVS: @(#) $Id: TraceCmd.3,v 1.2 2002/05/08 04:37:08 davygrvy Exp $ '\" .so man.macros .TH Tcl_TraceCommand 3 7.4 Tcl "Tcl Library Procedures" @@ -140,7 +140,7 @@ that renaming takes precedence over the one that triggered the trace and the collection of traces will not be reexecuted; if several traces rename the command, the last renaming takes precedence. -..SH "TCL_TRACE_DESTROYED FLAG" +.SH "TCL_TRACE_DESTROYED FLAG" .PP In a delete callback to \fIproc\fR, the TCL_TRACE_DESTROYED bit is set in \fIflags\fR. diff --git a/doc/file.n b/doc/file.n index a59050e..8332f6d 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.15 2002/05/02 20:15:20 vincentdarley Exp $ +'\" RCS: @(#) $Id: file.n,v 1.16 2002/05/08 04:36:54 davygrvy Exp $ '\" .so man.macros .TH file n 8.3 Tcl "Tcl Built-In Commands" @@ -226,21 +226,19 @@ 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 @@ -355,10 +353,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 . -- cgit v0.12