summaryrefslogtreecommitdiffstats
path: root/doc/package.n
diff options
context:
space:
mode:
authordgp <dgp@users.sourceforge.net>2002-01-27 17:35:06 (GMT)
committerdgp <dgp@users.sourceforge.net>2002-01-27 17:35:06 (GMT)
commit3012a6bae3fb1534e0dbf83a9b31a8866ad4be21 (patch)
treef380856bb9b4e4330cfb4b628443c16f0431b44b /doc/package.n
parent22bb660bc6f7ab06cef0629d9f88a231ce5d2b7b (diff)
downloadtcl-3012a6bae3fb1534e0dbf83a9b31a8866ad4be21.zip
tcl-3012a6bae3fb1534e0dbf83a9b31a8866ad4be21.tar.gz
tcl-3012a6bae3fb1534e0dbf83a9b31a8866ad4be21.tar.bz2
* Documented global namespace context for script evaluation
by [package require].
Diffstat (limited to 'doc/package.n')
-rw-r--r--doc/package.n8
1 files changed, 5 insertions, 3 deletions
diff --git a/doc/package.n b/doc/package.n
index c39bc33..1ede10f 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.5 2000/09/07 14:27:50 poenitz Exp $
+'\" RCS: @(#) $Id: package.n,v 1.6 2002/01/27 17:35:06 dgp Exp $
'\"
.so man.macros
.TH package n 7.5 Tcl "Tcl Built-In Commands"
@@ -114,12 +114,14 @@ the command returns immediately.
Otherwise, the command searches the database of information provided by
previous \fBpackage ifneeded\fR commands to see if an acceptable
version of the package is available.
-If so, the script for the highest acceptable version number is invoked;
+If so, the script for the highest acceptable version number is evaluated
+in the global namespace;
it must do whatever is necessary to load the package,
including calling \fBpackage provide\fR for the package.
If the \fBpackage ifneeded\fR database does not contain an acceptable
version of the package and a \fBpackage unknown\fR command has been
-specified for the interpreter then that command is invoked; when
+specified for the interpreter then that command is evaluated in the
+global namespace; when
it completes, Tcl checks again to see if the package is now provided
or if there is a \fBpackage ifneeded\fR script for it.
If all of these steps fail to provide an acceptable version of the