summaryrefslogtreecommitdiffstats
path: root/doc/load.n
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2012-11-07 08:03:10 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2012-11-07 08:03:10 (GMT)
commitca3ab36dfd57c0b369066af3364dd3ede7dbb684 (patch)
treece8aaef67aa0fe96f08821954b71216a91a10eea /doc/load.n
parent96e7bb4e2414da3ff01636dea1a8ffa9eb1080da (diff)
downloadtcl-ca3ab36dfd57c0b369066af3364dd3ede7dbb684.zip
tcl-ca3ab36dfd57c0b369066af3364dd3ede7dbb684.tar.gz
tcl-ca3ab36dfd57c0b369066af3364dd3ede7dbb684.tar.bz2
Finish the TIP #416 implementation as specified (#define's were still missing). Added warning to "load" documentation. Added test case for using -global without specifying filename.
Diffstat (limited to 'doc/load.n')
-rw-r--r--doc/load.n11
1 files changed, 9 insertions, 2 deletions
diff --git a/doc/load.n b/doc/load.n
index 7f7c624..7c2687e 100644
--- a/doc/load.n
+++ b/doc/load.n
@@ -110,9 +110,16 @@ found in the shared library are exported for global use by other
libraries. The option \fB\-lazy\fR delays the actual loading of
symbols until their first actual use. The options may be abbreviated.
The option \fB\-\-\fR indicates the end of the options, and should
-be used if you wish to use a filename which starts with \fB\-\fR.
+be used if you wish to use a filename which starts with \fB\-\fR
+and you provide a packageName to the \fBload\fR command.
+.PP
On platforms which do not support the \fB\-global\fR or \fB\-lazy\fR
-options, the options still exist but have no effect.
+options, the options still exist but have no effect. Note that use
+of the \fB\-global\fR or \fB\-lazy\fR option may lead to crashes
+in your application later (in case of symbol conflicts resp. missing
+symbols), which cannot be detected during the \fBload\fR. So, only
+use this when you know what you are doing, you will not get a nice
+error message when something is wrong with the loaded library.
.SH "PORTABILITY ISSUES"
.TP
\fBWindows\fR\0\0\0\0\0