diff options
author | dgp <dgp@users.sourceforge.net> | 2007-09-11 17:46:05 (GMT) |
---|---|---|
committer | dgp <dgp@users.sourceforge.net> | 2007-09-11 17:46:05 (GMT) |
commit | 05d4bff61c4b959be0020c6a2b74a82cddb1e71e (patch) | |
tree | f9882b020d2a79da2aa09179a4c91ed93282b18f /doc/package.n | |
parent | 7ad8b091dd878126106f9c18e855d17909f1068c (diff) | |
download | tcl-05d4bff61c4b959be0020c6a2b74a82cddb1e71e.zip tcl-05d4bff61c4b959be0020c6a2b74a82cddb1e71e.tar.gz tcl-05d4bff61c4b959be0020c6a2b74a82cddb1e71e.tar.bz2 |
* doc/package.n: Restored the functioning of
* generic/tclPkg.c: [package require -exact] to be compatible
* tests/pkg.test: with Tcl 8.4. [Bug 1578344].
Diffstat (limited to 'doc/package.n')
-rw-r--r-- | doc/package.n | 29 |
1 files changed, 11 insertions, 18 deletions
diff --git a/doc/package.n b/doc/package.n index 6231a1f..5db0f2f 100644 --- a/doc/package.n +++ b/doc/package.n @@ -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: package.n,v 1.16 2007/09/10 14:59:55 dgp Exp $ +'\" RCS: @(#) $Id: package.n,v 1.17 2007/09/11 17:46:07 dgp Exp $ '\" .so man.macros .TH package n 7.5 Tcl "Tcl Built-In Commands" @@ -17,9 +17,11 @@ package \- Facilities for package loading and version control \fBpackage forget ?\fIpackage package ...\fR? \fBpackage ifneeded \fIpackage version\fR ?\fIscript\fR? \fBpackage names\fR -\fBpackage present \fR?\fB\-exact\fR? \fIpackage \fR?\fIrequirement...\fR? +\fBpackage present \fIpackage \fR?\fIrequirement...\fR? +\fBpackage present \-exact \fIpackage version\fR \fBpackage provide \fIpackage \fR?\fIversion\fR? -\fBpackage require \fR?\fB\-exact\fR? \fIpackage \fR?\fIrequirement...\fR? +\fBpackage require \fIpackage \fR?\fIrequirement...\fR? +\fBpackage require \-exact \fIpackage version\fR \fBpackage unknown \fR?\fIcommand\fR? \fBpackage vcompare \fIversion1 version2\fR \fBpackage versions \fIpackage\fR @@ -77,7 +79,7 @@ interpreter for which a version has been provided (via script is available. The order of elements in the list is arbitrary. .TP -\fBpackage present \fR?\fB\-exact\fR? \fIpackage \fR?\fIversion\fR? +\fBpackage present\fR This command is equivalent to \fBpackage require\fR except that it does not try and load the package if it is not already loaded. .TP @@ -93,20 +95,6 @@ returns the version number that is currently provided, or an empty string if no \fBpackage provide\fR command has been invoked for \fIpackage\fR in this interpreter. .TP -\fBpackage require \fR\fB\-exact\fR \fIpackage \fR\fIversion\fR -This form of the command is translated to the form below using the -bounded requirement "version-(version+1)", making only the given -\fIversion\fR acceptable, within the specified level of detail. Deeper -levels are allowed to vary. Examples: -.CS - -exact 8 => 8-9 - -exact 8.4 => 8.4-8.5 - -exact 8.4.14 => 8.4.14-8.4.15 -.CE -.RS -For more explanations see below. -.RE -.TP \fBpackage require \fR\fIpackage \fR?\fIrequirement...\fR? This command is typically invoked by Tcl code that wishes to use a particular version of a particular package. The arguments @@ -149,6 +137,11 @@ If all of these steps fail to provide an acceptable version of the package, then the command returns an error. .RE .TP +\fBpackage require \-exact \fIpackage version\fR +This form of the command is used when only the given \fIversion\fR +of \fIpackage\fR is acceptable to the caller. This command is +equivalent to \fBpackage require \fIpackage version\fR-\fIversion\fR. +.TP \fBpackage unknown \fR?\fIcommand\fR? This command supplies a ``last resort'' command to invoke during \fBpackage require\fR if no suitable version of a package can be found |