? 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 \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 \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)