Attachment "tcl-doc-patch.txt" to
ticket [490514ffff]
added by
jenglish
2001-12-08 10:41:54.
? 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)