? patch.txt
Index: Access.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/Access.3,v
retrieving revision 1.4
diff -c -r1.4 Access.3
*** Access.3	2001/07/31 19:12:05	1.4
--- Access.3	2001/12/08 03:26:12
***************
*** 72,75 ****
  given.
  
  .SH KEYWORDS
! stat access
--- 72,75 ----
  given.
  
  .SH KEYWORDS
! stat, access
Index: CrtChannel.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/CrtChannel.3,v
retrieving revision 1.11
diff -c -r1.11 CrtChannel.3
*** CrtChannel.3	2001/09/11 18:29:56	1.11
--- CrtChannel.3	2001/12/08 03:26:12
***************
*** 211,217 ****
  call to \fBTcl_GetStdChannel\fR or a call to \fBTcl_SetStdChannel\fR
  closing this standard channel will cause the next call to
  \fBTcl_CreateChannel\fR to make the new channel the new standard
! channel too. See \fBTcl_StandardChannel\fR for a general treatise
  about standard channels and the behaviour of the Tcl library with
  regard to them.
  .PP
--- 211,217 ----
  call to \fBTcl_GetStdChannel\fR or a call to \fBTcl_SetStdChannel\fR
  closing this standard channel will cause the next call to
  \fBTcl_CreateChannel\fR to make the new channel the new standard
! channel too. See \fBTcl_StandardChannels\fR for a general treatise
  about standard channels and the behaviour of the Tcl library with
  regard to them.
  .PP
Index: DString.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/DString.3,v
retrieving revision 1.6
diff -c -r1.6 DString.3
*** DString.3	2001/09/24 21:10:32	1.6
--- DString.3	2001/12/08 03:26:12
***************
*** 11,17 ****
  .TH Tcl_DString 3 7.4 Tcl "Tcl Library Procedures"
  .BS
  .SH NAME
! Tcl_DStringInit, Tcl_DStringAppend, Tcl_DStringAppendElement, Tcl_DStringStartSublist, Tcl_DStringEndSublist, Tcl_DStringLength, Tcl_DStringValue, Tcl_DStringSetLength, Tcl_DStringFree, Tcl_DStringResult, Tcl_DStringGetResult \- manipulate dynamic strings
  .SH SYNOPSIS
  .nf
  \fB#include <tcl.h>\fR
--- 11,17 ----
  .TH Tcl_DString 3 7.4 Tcl "Tcl Library Procedures"
  .BS
  .SH NAME
! Tcl_DStringInit, Tcl_DStringAppend, Tcl_DStringAppendElement, Tcl_DStringStartSublist, Tcl_DStringEndSublist, Tcl_DStringLength, Tcl_DStringValue, Tcl_DStringSetLength, Tcl_DStringTrunc, Tcl_DStringFree, Tcl_DStringResult, Tcl_DStringGetResult \- manipulate dynamic strings
  .SH SYNOPSIS
  .nf
  \fB#include <tcl.h>\fR
Index: ExprLong.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/ExprLong.3,v
retrieving revision 1.4
diff -c -r1.4 ExprLong.3
*** ExprLong.3	2001/04/24 20:59:17	1.4
--- ExprLong.3	2001/12/08 03:26:12
***************
*** 56,62 ****
  The expression can have any of the forms accepted by the \fBexpr\fR command.
  Note that these procedures have been largely replaced by the
  object-based procedures \fBTcl_ExprLongObj\fR, \fBTcl_ExprDoubleObj\fR,
! \fBTcl_ExprBooleanObj\fR, and \fBTcl_ExprStringObj\fR.
  Those object-based procedures evaluate an expression held in a Tcl object
  instead of a string.
  The object argument can retain an internal representation
--- 56,62 ----
  The expression can have any of the forms accepted by the \fBexpr\fR command.
  Note that these procedures have been largely replaced by the
  object-based procedures \fBTcl_ExprLongObj\fR, \fBTcl_ExprDoubleObj\fR,
! \fBTcl_ExprBooleanObj\fR, and \fBTcl_ExprObj\fR.
  Those object-based procedures evaluate an expression held in a Tcl object
  instead of a string.
  The object argument can retain an internal representation
Index: FileSystem.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/FileSystem.3,v
retrieving revision 1.12
diff -c -r1.12 FileSystem.3
*** FileSystem.3	2001/11/19 17:45:12	1.12
--- FileSystem.3	2001/12/08 03:26:13
***************
*** 7,13 ****
  '\" RCS: @(#) $Id: FileSystem.3,v 1.12 2001/11/19 17:45:12 vincentdarley Exp $
  '\" 
  .so man.macros
! .TH Tcl_FSCopyFile 3 8.4 Tcl "Tcl Library Procedures"
  .BS
  .SH NAME
  Tcl_FSRegister, Tcl_FSUnregister, Tcl_FSData, Tcl_FSCopyFile, Tcl_FSCopyDirectory, Tcl_FSCreateDirectory, Tcl_FSDeleteFile, Tcl_FSRemoveDirectory, Tcl_FSRenameFile, Tcl_FSListVolumes, Tcl_FSEvalFile, Tcl_FSLoadFile, Tcl_FSMatchInDirectory, Tcl_FSLink, Tcl_FSLstat, Tcl_FSUtime, Tcl_FSFileAttrsGet, Tcl_FSFileAttrsSet, Tcl_FSFileAttrStrings, Tcl_FSStat, Tcl_FSAccess, Tcl_FSOpenFileChannel, Tcl_FSGetCwd, Tcl_FSChdir, Tcl_FSPathSeparator, Tcl_FSJoinPath, Tcl_FSSplitPath, Tcl_FSEqualPaths, Tcl_FSGetNormalizedPath, Tcl_FSJoinToPath, Tcl_FSConvertToPathType, Tcl_FSGetInternalRep, Tcl_FSGetTranslatedPath, Tcl_FSGetTranslatedStringPath, Tcl_FSNewNativePath, Tcl_FSGetNativePath, Tcl_FSFileSystemInfo \- procedures to interact with any filesystem
--- 7,13 ----
  '\" RCS: @(#) $Id: FileSystem.3,v 1.12 2001/11/19 17:45:12 vincentdarley Exp $
  '\" 
  .so man.macros
! .TH Filesystem 3 8.4 Tcl "Tcl Library Procedures"
  .BS
  .SH NAME
  Tcl_FSRegister, Tcl_FSUnregister, Tcl_FSData, Tcl_FSCopyFile, Tcl_FSCopyDirectory, Tcl_FSCreateDirectory, Tcl_FSDeleteFile, Tcl_FSRemoveDirectory, Tcl_FSRenameFile, Tcl_FSListVolumes, Tcl_FSEvalFile, Tcl_FSLoadFile, Tcl_FSMatchInDirectory, Tcl_FSLink, Tcl_FSLstat, Tcl_FSUtime, Tcl_FSFileAttrsGet, Tcl_FSFileAttrsSet, Tcl_FSFileAttrStrings, Tcl_FSStat, Tcl_FSAccess, Tcl_FSOpenFileChannel, Tcl_FSGetCwd, Tcl_FSChdir, Tcl_FSPathSeparator, Tcl_FSJoinPath, Tcl_FSSplitPath, Tcl_FSEqualPaths, Tcl_FSGetNormalizedPath, Tcl_FSJoinToPath, Tcl_FSConvertToPathType, Tcl_FSGetInternalRep, Tcl_FSGetTranslatedPath, Tcl_FSGetTranslatedStringPath, Tcl_FSNewNativePath, Tcl_FSGetNativePath, Tcl_FSFileSystemInfo \- procedures to interact with any filesystem
***************
*** 543,550 ****
  .PP
  A valid list object is returned, unless the path object is not
  recognized, when NULL will be returned.
- .PP
- 
  .SH TCL_FILESYSTEM
  .PP
  A filesystem provides a \fBTcl_Filesystem\fR structure that contains
--- 543,548 ----
***************
*** 636,642 ****
  those names in UTF\-8 form.  The filesystem infrastructure API is
  designed to support efficient, cached conversion of these UTF\-8 paths
  to other native representations.
- .PP
  .SH TYPENAME
  .PP
  The \fItypeName\fR field contains a null-terminated string that
--- 634,639 ----
***************
*** 649,666 ****
  \fIsizeof(Tcl_Filesystem)\fR, and is there to allow easier
  binary backwards compatibility if the size of the structure
  changes in a future Tcl release.
- .PP
  .SH VERSION
  .PP
  The \fIversion\fR field should be set to \fBTCL_FILESYSTEM_VERSION_1\fR.
  .PP
- .SH FILESYSTEM INFRASTRUCTURE
- .PP
  These fields contain addresses of functions which are used to associate
  a particular filesystem with a file path, and deal with the internal
  handling of path representations, for example copying and freeing such
  representations.
- .PP
  .SH PATHINFILESYSTEMPROC
  .PP
  The \fIpathInFilesystemProc\fR field contains the address of a function
--- 646,660 ----
  \fIsizeof(Tcl_Filesystem)\fR, and is there to allow easier
  binary backwards compatibility if the size of the structure
  changes in a future Tcl release.
  .SH VERSION
  .PP
  The \fIversion\fR field should be set to \fBTCL_FILESYSTEM_VERSION_1\fR.
+ .SH "FILESYSTEM INFRASTRUCTURE"
  .PP
  These fields contain addresses of functions which are used to associate
  a particular filesystem with a file path, and deal with the internal
  handling of path representations, for example copying and freeing such
  representations.
  .SH PATHINFILESYSTEMPROC
  .PP
  The \fIpathInFilesystemProc\fR field contains the address of a function
***************
*** 682,688 ****
  	Tcl_Obj *\fIpathPtr\fR, 
  	ClientData *\fIclientDataPtr\fR);
  .CE
- .PP
  .SH DUPINTERNALREPPROC
  .PP
  This function makes a copy of a path's internal representation, and is
--- 676,681 ----
***************
*** 694,700 ****
  typedef ClientData Tcl_FSDupInternalRepProc(
  	ClientData \fIclientData\fR);
  .CE
- .PP
  .SH FREEINTERNALREPPROC
  Free the internal representation.  This must be implemented if internal
  representations need freeing (i.e. if some memory is allocated when an
--- 687,692 ----
***************
*** 704,710 ****
  typedef void Tcl_FSFreeInternalRepProc(
  	ClientData \fIclientData\fR);
  .CE
- .PP
  .SH INTERNALTONORMALIZEDPROC
  .PP
  Function to convert internal representation to a normalized path.  Only
--- 696,701 ----
***************
*** 716,722 ****
  typedef Tcl_Obj* Tcl_FSInternalToNormalizedProc(
  	ClientData \fIclientData\fR);
  .CE
- .PP
  .SH CREATEINTERNALREPPROC
  .PP
  Function to take a path object, and calculate an internal
--- 707,712 ----
***************
*** 729,735 ****
  typedef ClientData Tcl_FSCreateInternalRepProc(
  	Tcl_Obj *\fIpathPtr\fR);
  .CE
- .PP
  .SH NORMALIZEPATHPROC       
  .PP
  Function to normalize a path.  Should be implemented for all
--- 719,724 ----
***************
*** 747,754 ****
  	Tcl_Obj *\fIpathPtr\fR, 
  	int \fInextCheckpoint\fR);
  .CE
! .PP
! .SH FILESYSTEM OPERATIONS
  .PP
  The fields in this section of the structure contain addresses of
  functions which are called to carry out the basic filesystem
--- 736,742 ----
  	Tcl_Obj *\fIpathPtr\fR, 
  	int \fInextCheckpoint\fR);
  .CE
! .SH "FILESYSTEM OPERATIONS"
  .PP
  The fields in this section of the structure contain addresses of
  functions which are called to carry out the basic filesystem
***************
*** 760,766 ****
  implement the last four functions, and a filesystem which does not
  support symbolic links need not implement the \fBreadlink\fR function,
  etc.  The Tcl core expects filesystems to behave in this way).
- .PP
  .SH FILESYSTEMPATHTYPEPROC
  .PP
  Function to determine the type of a path in this filesystem.  May be
--- 748,753 ----
***************
*** 774,780 ****
  typedef Tcl_Obj* Tcl_FSFilesystemPathTypeProc(
  	Tcl_Obj *\fIpathPtr\fR);
  .CE
- .PP
  .SH FILESYSTEMSEPARATORPROC
  .PP
  Function to return the separator character(s) for this filesystem.
--- 761,766 ----
***************
*** 786,792 ****
  typedef Tcl_Obj* Tcl_FSFilesystemSeparatorProc(
  	Tcl_Obj *\fIpathPtr\fR);
  .CE
- .PP
  .SH STATPROC 
  .PP
  Function to process a \fBTcl_FSStat()\fR call.  Must be implemented for any
--- 772,777 ----
***************
*** 813,819 ****
  If the file represented by \fIpathPtr\fR exists, the
  \fBTcl_FSStatProc\fR returns 0 and the stat structure is filled with
  data.  Otherwise, -1 is returned, and no stat info is given.
- .PP
  .SH ACCESSPROC	    
  .PP
  Function to process a \fBTcl_FSAccess()\fR call.  Must be implemented for
--- 798,803 ----
***************
*** 867,873 ****
  the standard channels, \fBstdin, stdout\fR or \fBstderr\fR was
  previously closed, the act of creating the new channel also assigns it
  as a replacement for the standard channel.
- .PP
  .SH MATCHINDIRECTORYPROC  
  .PP
  Function to process a \fBTcl_FSMatchInDirectory()\fR call.  If not
--- 851,856 ----
***************
*** 897,903 ****
  (which can be assumed to be a valid Tcl list).  The matches added
  to \fIresult\fR should include any path prefix given in \fIpathPtr\fR 
  (this usually means they will be absolute path specifications).
-  .PP
  .SH UTIMEPROC       
  .PP
  Function to process a \fBTcl_FSUtime()\fR call.  Required to allow setting
--- 880,885 ----
***************
*** 915,921 ****
  .PP
  The return value is a standard Tcl result indicating whether an error
  occurred in the process.
- .PP
  .SH LINKPROC 
  .PP
  Function to process a \fBTcl_FSLink()\fR call.  Should be implemented
--- 897,902 ----
***************
*** 935,941 ****
  is not NULL, the function should attempt to create a link.  The result
  in this case should be \fItoPtr\fR if the link was successful and NULL
  otherwise.  In this case the result is not owned by the caller.
- .PP
  .SH LISTVOLUMESPROC	    
  .PP
  Function to list any filesystem volumes added by this filesystem.
--- 916,921 ----
***************
*** 982,988 ****
  the list should be disposed of by Tcl when done, it should have a
  refCount of zero, and if the list should not be disposed of, the
  filesystem should ensure it retains a refCount on the object.
- .PP
  .SH FILEATTRSGETPROC
  .PP
  Function to process a \fBTcl_FSFileAttrsGet()\fR call, used by 'file
--- 962,967 ----
***************
*** 1002,1008 ****
  TCL_OK was returned) and is likely to have a refCount of zero.  Either
  way we must either store it somewhere (e.g. the Tcl result), or
  Incr/Decr its refCount to ensure it is properly freed.
- .PP
  .SH FILEATTRSSETPROC
  .PP
  Function to process a \fBTcl_FSFileAttrsSet()\fR call, used by 'file
--- 981,986 ----
***************
*** 1019,1025 ****
  .PP
  The attribute value of the \fIindex\fR'th element in the list returned by
  the Tcl_FSFileAttrStringsProc should be set to the \fIobjPtr\fR given.
- .PP
  .SH CREATEDIRECTORYPROC	    
  .PP
  Function to process a \fBTcl_FSCreateDirectory()\fR call.  Should be
--- 997,1002 ----
***************
*** 1034,1040 ****
  occurred in the process.  If successful, a new directory should have
  been added to the filesystem in the location specified by
  \fIpathPtr\fR.
- .PP
  .SH REMOVEDIRECTORYPROC	    
  .PP
  Function to process a 'Tcl_FSRemoveDirectory()' call.  Should be
--- 1011,1016 ----
***************
*** 1054,1060 ****
  be deleted without error.  If an error does occur, the name of
  the file or directory which caused the error should be placed in
  \fIerrorPtr\fR.
- .PP
  .SH DELETEFILEPROC	    
  .PP
  Function to process a \fBTcl_FSDeleteFile()\fR call.  Should be implemented
--- 1030,1035 ----
***************
*** 1068,1076 ****
  The return value is a standard Tcl result indicating whether an error
  occurred in the process.  If successful, the file specified by
  \fIpathPtr\fR should have been removed from the filesystem.
  .PP
- .SH FILESYSTEM EFFICIENCY
- .PP
  .SH LSTATPROC	    
  .PP
  Function to process a \fBTcl_FSLstat()\fR call.  If not implemented, Tcl
--- 1043,1050 ----
  The return value is a standard Tcl result indicating whether an error
  occurred in the process.  If successful, the file specified by
  \fIpathPtr\fR should have been removed from the filesystem.
+ .SH "FILESYSTEM EFFICIENCY"
  .PP
  .SH LSTATPROC	    
  .PP
  Function to process a \fBTcl_FSLstat()\fR call.  If not implemented, Tcl
***************
*** 1108,1114 ****
  is never the name of a directory into which \fIsrcPathPtr\fR could be
  copied (i.e. the function is much simpler than the Tcl level 'file
  copy' subcommand).
- .PP
  .SH RENAMEFILEPROC	    
  .PP
  Function to process a \fBTcl_FSRenameFile()\fR call.  If not implemented,
--- 1082,1087 ----
***************
*** 1124,1130 ****
  .PP
  The return value is a standard Tcl result indicating whether an error
  occurred in the renaming process.
- .PP
  .SH COPYDIRECTORYPROC	    
  .PP
  Function to process a \fBTcl_FSCopyDirectory()\fR call.  If not
--- 1097,1102 ----
***************
*** 1147,1153 ****
  \fIsrcPathPtr\fR. It is not the name of a directory into which
  \fIsrcPathPtr\fR should be copied (i.e. the function is much simpler
  than the Tcl level 'file copy' subcommand).
- .PP
  .SH LOADFILEPROC 
  .PP
  Function to process a \fBTcl_FSLoadFile()\fR call.  If not implemented, Tcl
--- 1119,1124 ----
***************
*** 1177,1183 ****
  filled in with the address of a procedure.  The procedure will be
  called with the given clientData as its only parameter when Tcl 
  needs to unload the file.
- .PP
  .SH UNLOADFILEPROC	    
  .PP
  Function to unload a previously successfully loaded file.  If load was
--- 1148,1153 ----
***************
*** 1188,1194 ****
  typedef void Tcl_FSUnloadFileProc(
  	ClientData \fIclientData\fR);
  .CE
- .PP
  .SH GETCWDPROC     
  .PP
  Function to process a \fBTcl_FSGetCwd()\fR call.  Most filesystems need not
--- 1158,1163 ----
***************
*** 1227,1234 ****
  The \fBTcl_FSChdirProc\fR changes the applications current working
  directory to the value specified in \fIpathPtr\fR. The function returns
  -1 on error or 0 on success.
- .PP
- 
  .SH KEYWORDS
  stat access filesystem vfs
  
--- 1196,1201 ----
Index: GetStdChan.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/GetStdChan.3,v
retrieving revision 1.3
diff -c -r1.3 GetStdChan.3
*** GetStdChan.3	2001/09/10 21:49:37	1.3
--- GetStdChan.3	2001/12/08 03:26:13
***************
*** 66,72 ****
  assigned starting with standard input, followed by standard output, with
  standard error being last.
  .PP
! See \fBTcl_StandardChannel\fR for a general treatise about standard
  channels and the behaviour of the Tcl library with regard to them.
  .PP
  
--- 66,72 ----
  assigned starting with standard input, followed by standard output, with
  standard error being last.
  .PP
! See \fBTcl_StandardChannels\fR for a general treatise about standard
  channels and the behaviour of the Tcl library with regard to them.
  .PP
  
Index: OpenFileChnl.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/OpenFileChnl.3,v
retrieving revision 1.14
diff -c -r1.14 OpenFileChnl.3
*** OpenFileChnl.3	2001/12/07 17:38:33	1.14
--- OpenFileChnl.3	2001/12/08 03:26:13
***************
*** 350,356 ****
  This procedure interacts with the code managing the standard
  channels. If no standard channels were initialized before the first
  call to \fBTcl_RegisterChannel\fR they will get initialized by that
! call. See \fBTcl_StandardChannel\fR for a general treatise about
  standard channels and the behaviour of the Tcl library with regard to
  them.
  
--- 350,356 ----
  This procedure interacts with the code managing the standard
  channels. If no standard channels were initialized before the first
  call to \fBTcl_RegisterChannel\fR they will get initialized by that
! call. See \fBTcl_StandardChannels\fR for a general treatise about
  standard channels and the behaviour of the Tcl library with regard to
  them.
  
Index: StdChannels.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/StdChannels.3,v
retrieving revision 1.6
diff -c -r1.6 StdChannels.3
*** StdChannels.3	2001/11/14 23:38:39	1.6
--- StdChannels.3	2001/12/08 03:26:13
***************
*** 34,40 ****
  \fBTcl_GetStdChannel\fR and \fBTcl_SetStdChannel\fR. Additional public
  APIs to consider are \fBTcl_RegisterChannel\fR,
  \fBTcl_CreateChannel\fR and \fBTcl_GetChannel\fR.
! .SH Initialization of Tcl standard channels
  .PP
  Standard channels are initialized by the Tcl library in three cases:
  when explicitly requested, when implicitly required before returning
--- 34,40 ----
  \fBTcl_GetStdChannel\fR and \fBTcl_SetStdChannel\fR. Additional public
  APIs to consider are \fBTcl_RegisterChannel\fR,
  \fBTcl_CreateChannel\fR and \fBTcl_GetChannel\fR.
! .SH "INITIALIZATION OF TCL STANDARD CHANNELS"
  .PP
  Standard channels are initialized by the Tcl library in three cases:
  when explicitly requested, when implicitly required before returning
***************
*** 89,95 ****
  words, of the first four Tcl channels opened by the application the
  second to fourth are designated as the Tcl standard channels.
  .PP
! .SH Re-initialization of Tcl standard channels
  .PP
  Once a Tcl standard channel is initialized through one of the methods
  above, closing this Tcl standard channel will cause the next call to
--- 89,95 ----
  words, of the first four Tcl channels opened by the application the
  second to fourth are designated as the Tcl standard channels.
  .PP
! .SH "RE-INITIALIZATION OF TCL STANDARD CHANNELS"
  .PP
  Once a Tcl standard channel is initialized through one of the methods
  above, closing this Tcl standard channel will cause the next call to
Index: TCL_MEM_DEBUG.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/TCL_MEM_DEBUG.3,v
retrieving revision 1.3
diff -c -r1.3 TCL_MEM_DEBUG.3
*** TCL_MEM_DEBUG.3	2001/09/27 22:25:45	1.3
--- TCL_MEM_DEBUG.3	2001/12/08 03:26:13
***************
*** 18,24 ****
  memory leaks, memory allocation overruns, and other memory related
  errors.
  
! .SH ENABLING MEMORY DEBUGGING
  .PP
  To enable memory debugging, Tcl should be recompiled from scratch with
  \fBTCL_MEM_DEBUG\fR defined.  This will also compile in a non-stub
--- 18,24 ----
  memory leaks, memory allocation overruns, and other memory related
  errors.
  
! .SH "ENABLING MEMORY DEBUGGING"
  .PP
  To enable memory debugging, Tcl should be recompiled from scratch with
  \fBTCL_MEM_DEBUG\fR defined.  This will also compile in a non-stub
***************
*** 34,40 ****
  and the Tcl \fBmemory\fR command can be used to validate and examine
  memory usage.
  
! .SH GUARD ZONES
  .PP
  When memory debugging is enabled, whenever a call to \fBckalloc\fR is
  made, slightly more memory than requested is allocated so the memory debugging
--- 34,40 ----
  and the Tcl \fBmemory\fR command can be used to validate and examine
  memory usage.
  
! .SH "GUARD ZONES"
  .PP
  When memory debugging is enabled, whenever a call to \fBckalloc\fR is
  made, slightly more memory than requested is allocated so the memory debugging
***************
*** 55,61 ****
  not enough space was allocated to contain the data written, for
  example.
  
! .SH DEBUGGING DIFFICULT MEMORY CORRUPTION PROBLEMS
  .PP
  Normally, Tcl compiled with memory debugging enabled will make it easy
  to isolate a corruption problem.  Turning on memory validation with
--- 55,61 ----
  not enough space was allocated to contain the data written, for
  example.
  
! .SH "DEBUGGING DIFFICULT MEMORY CORRUPTION PROBLEMS"
  .PP
  Normally, Tcl compiled with memory debugging enabled will make it easy
  to isolate a corruption problem.  Turning on memory validation with
Index: Tcl_Main.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/Tcl_Main.3,v
retrieving revision 1.4
diff -c -r1.4 Tcl_Main.3
*** Tcl_Main.3	2001/09/10 21:49:37	1.4
--- Tcl_Main.3	2001/12/08 03:26:13
***************
*** 80,86 ****
  .PP
  \fBTcl_Main\fR and therefore all applications based upon it, like
  \fBtclsh\fR, use \fBTcl_GetStdChannel\fR to initialize the standard
! channels to their default values. See \fBTcl_StandardChannel\fR for
  more information.
  
  .SH "SEE ALSO"
--- 80,86 ----
  .PP
  \fBTcl_Main\fR and therefore all applications based upon it, like
  \fBtclsh\fR, use \fBTcl_GetStdChannel\fR to initialize the standard
! channels to their default values. See \fBTcl_StandardChannels\fR for
  more information.
  
  .SH "SEE ALSO"
Index: Utf.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/Utf.3,v
retrieving revision 1.9
diff -c -r1.9 Utf.3
*** Utf.3	2001/04/06 23:14:08	1.9
--- Utf.3	2001/12/08 03:26:13
***************
*** 150,156 ****
  end of the \fBTcl_DString\fR.
  .PP
  \fBTcl_UtfToUniCharDString\fR coverts the given UTF-8 string to Unicode,
! storing the result in the previously-initialized \fBTcl_Dstring\fR.
  you may either specify the length of the given UTF-8 string or "-1",
  in which case \fBTcl_UtfToUniCharDString\fR uses \fBstrlen\fR to
  calculate the length.  The return value is a pointer to the Unicode
--- 150,156 ----
  end of the \fBTcl_DString\fR.
  .PP
  \fBTcl_UtfToUniCharDString\fR coverts the given UTF-8 string to Unicode,
! storing the result in the previously-initialized \fBTcl_DString\fR.
  you may either specify the length of the given UTF-8 string or "-1",
  in which case \fBTcl_UtfToUniCharDString\fR uses \fBstrlen\fR to
  calculate the length.  The return value is a pointer to the Unicode
Index: file.n
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/file.n,v
retrieving revision 1.12
diff -c -r1.12 file.n
*** file.n	2001/11/19 17:45:12	1.12
--- file.n	2001/12/08 03:26:13
***************
*** 259,267 ****
  of the file it points to).  If \fIname\fR isn't a symbolic link or its
  value cannot be read, then an error is returned.  On systems that don't
  support symbolic links this option is undefined.
! .PP
  \fBfile rename \fR?\fB\-force\fR? ?\fB\-\|\-\fR? \fIsource\fR \fItarget\fR
! .br
  \fBfile rename \fR?\fB\-force\fR? ?\fB\-\|\-\fR? \fIsource\fR ?\fIsource\fR ...? \fItargetDir\fR
  .RS
  The first form takes the file or directory specified by pathname
--- 259,267 ----
  of the file it points to).  If \fIname\fR isn't a symbolic link or its
  value cannot be read, then an error is returned.  On systems that don't
  support symbolic links this option is undefined.
! .TP
  \fBfile rename \fR?\fB\-force\fR? ?\fB\-\|\-\fR? \fIsource\fR \fItarget\fR
! .TP
  \fBfile rename \fR?\fB\-force\fR? ?\fB\-\|\-\fR? \fIsource\fR ?\fIsource\fR ...? \fItargetDir\fR
  .RS
  The first form takes the file or directory specified by pathname
Index: tclsh.1
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/tclsh.1,v
retrieving revision 1.5
diff -c -r1.5 tclsh.1
*** tclsh.1	2001/09/10 21:49:37	1.5
--- tclsh.1	2001/12/08 03:26:13
***************
*** 125,131 ****
  
  .SH "STANDARD CHANNELS"
  .PP
! See \fBTcl_StandardChannel\fR for more explanations.
  
  .SH "SEE ALSO"
  fconfigure(1), tclvars(1)
--- 125,131 ----
  
  .SH "STANDARD CHANNELS"
  .PP
! See \fBTcl_StandardChannels\fR for more explanations.
  
  .SH "SEE ALSO"
  fconfigure(1), tclvars(1)
