summaryrefslogtreecommitdiffstats
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
parent22bb660bc6f7ab06cef0629d9f88a231ce5d2b7b (diff)
downloadtcl-3012a6bae3fb1534e0dbf83a9b31a8866ad4be21.zip
tcl-3012a6bae3fb1534e0dbf83a9b31a8866ad4be21.tar.gz
tcl-3012a6bae3fb1534e0dbf83a9b31a8866ad4be21.tar.bz2
* Documented global namespace context for script evaluation
by [package require].
-rw-r--r--ChangeLog5
-rw-r--r--doc/package.n8
2 files changed, 10 insertions, 3 deletions
diff --git a/ChangeLog b/ChangeLog
index 52e7b4d..06cbf9d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2002-01-27 Don Porter <dgp@users.sourceforge.net>
+
+ * doc/package.n: Documented global namespace context for script
+ evaluation by [package require].
+
2001-01-27 Daniel Steffen <das@users.sourceforge.net>
* generic/tclInt.decls:
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