diff options
Diffstat (limited to 'doc/tm.n')
| -rw-r--r-- | doc/tm.n | 57 |
1 files changed, 37 insertions, 20 deletions
@@ -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. '\" -'\" RCS: @(#) $Id: tm.n,v 1.6 2007/02/18 18:42:55 dkf Exp $ +'\" RCS: @(#) $Id: tm.n,v 1.7 2007/10/24 14:29:39 dkf Exp $ '\" .so man.macros .TH tm n 8.5 Tcl "Tcl Built-In Commands" @@ -56,8 +56,11 @@ that they are searched for modules. .TP \fB::tcl::tm::roots\fR \fIpath\fR... Similar to \fBpath add\fR, and layered on top of it. This command -takes a list of paths, extends each with "\fBtcl\fIX\fB/site-tcl\fR", -and "\fBtcl\fIX\fB/\fIX\fB.\fIy\fR", for major version \fIX\fR of the +takes a list of paths, extends each with +.QW "\fBtcl\fIX\fB/site-tcl\fR" , +and +.QW "\fBtcl\fIX\fB/\fIX\fB.\fIy\fR" , +for major version \fIX\fR of the Tcl interpreter and minor version \fIy\fR less than or equal to the minor version of the interpreter, and adds the resulting set of paths to the list of paths to search. @@ -112,22 +115,37 @@ For any two directories, neither is an ancestor directory of the other. .PP This is required to avoid ambiguities in package naming. If for -example the two directories "\fIfoo/\fR" and "\fIfoo/cool\fR" were on -the path a package named \fBcool::ice\fR could be found via the -names \fBcool::ice\fR or \fBice\fR, the latter potentially -obscuring a package named \fBice\fR, unqualified. +example the two directories +.QW \fIfoo/\fR +and +.QW \fIfoo/cool\fR +were on +the path a package named +.QW \fBcool::ice\fR +could be found via the names +.QW \fBcool::ice\fR +or +.QW \fBice\fR , +the latter potentially obscuring a package named +.QW \fBice\fR , +unqualified. .PP Before the search is started, the name of the requested package is translated into a partial path, using the following algorithm: .IP -All occurrences of "\fB::\fR" in the package name are replaced by -the appropriate directory separator character for the platform we are -on. On Unix, for example, this is "\fB/\fR". +All occurrences of +.QW \fB::\fR +in the package name are replaced by the appropriate directory +separator character for the platform we are on. On Unix, for example, +this is +.QW \fB/\fR . .PP Example: .IP -The requested package is \fBencoding::base64\fR. The generated -partial path is "\fIencoding/base64\fR" +The requested package is +.QW \fBencoding::base64\fR . +The generated partial path is +.QW \fIencoding/base64\fR .PP After this translation the package is looked for in all module paths, by combining them one-by-one, first to last with the partial path to @@ -162,7 +180,8 @@ below: .PP Where \fBPNAME'\fR is the partial path of the module as defined in section \fBFINDING MODULES\fR, and translated into \fB\fRPNAME by -changing all directory separators to "\fB::\fR", +changing all directory separators to +.QW \fB::\fR , and \fBmodule_path\fR is the path (from the list of paths to search) that we found the module file under. .PP @@ -253,13 +272,11 @@ environment variables: \fB$::env(TCL8.0_TM_PATH)\fR .CE .RE - .SH "SEE ALSO" -package(n), Tcl Improvement Proposal #189 "\fITcl Modules\fR" (online -at http://tip.tcl.tk/189.html), Tcl Improvement Proposal #190 -"\fIImplementation Choices for Tcl Modules\fR" (online at -http://tip.tcl.tk/190.html) - - +package(n), Tcl Improvement Proposal #189 +.QW "\fITcl Modules\fR" +(online at http://tip.tcl.tk/189.html), Tcl Improvement Proposal #190 +.QW "\fIImplementation Choices for Tcl Modules\fR" +(online at http://tip.tcl.tk/190.html) .SH "KEYWORDS" modules, package |