summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2012-05-25 14:52:29 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2012-05-25 14:52:29 (GMT)
commitc0be36ea12bff6fe98ce0406dd19e708ddc89906 (patch)
treecf2dc0c375b1925ed633b5f9dfbb521cfebb6e67 /doc
parent423017faed3aa258b3fa9c04cf9c6f5289d355a8 (diff)
parentb317e4d6a30ce58b28482a6b884f3aed5a3f05f7 (diff)
downloadtcl-c0be36ea12bff6fe98ce0406dd19e708ddc89906.zip
tcl-c0be36ea12bff6fe98ce0406dd19e708ddc89906.tar.gz
tcl-c0be36ea12bff6fe98ce0406dd19e708ddc89906.tar.bz2
[Bug 3528418]: Document what is going on with respect to qualification of
command prefixes in ensemble subcommand maps.
Diffstat (limited to 'doc')
-rw-r--r--doc/Ensemble.32
-rw-r--r--doc/namespace.n5
2 files changed, 6 insertions, 1 deletions
diff --git a/doc/Ensemble.3 b/doc/Ensemble.3
index 8a8c74e..cd69bbd 100644
--- a/doc/Ensemble.3
+++ b/doc/Ensemble.3
@@ -159,6 +159,8 @@ code (\fBTCL_OK\fR, or \fBTCL_ERROR\fR if the token does not refer to an
ensemble) and the dictionary obtained from
\fBTcl_GetEnsembleMappingDict\fR should always be treated as immutable
even if it is unshared.
+All command names in prefixes set via \fBTcl_SetEnsembleMappingDict\fR
+must be fully qualified.
.TP
\fBformal pre-subcommand parameter list\fR (read-write)
.VS 8.6
diff --git a/doc/namespace.n b/doc/namespace.n
index a32c2f3..b06d27a 100644
--- a/doc/namespace.n
+++ b/doc/namespace.n
@@ -778,7 +778,10 @@ When non-empty, this option supplies a dictionary that provides a
mapping from subcommand names to a list of prefix words to substitute
in place of the ensemble command and subcommand words (in a manner
similar to an alias created with \fBinterp alias\fR; the words are not
-reparsed after substitution). When this option is empty, the mapping
+reparsed after substitution); if the first word of any target is not
+fully qualified when set, it is assumed to be relative to the
+\fIcurrent\fR namespace and changed to be exactly that (that is, it is
+always fully qualified when read). When this option is empty, the mapping
will be from the local name of the subcommand to its fully-qualified
name. Note that when this option is non-empty and the
\fB\-subcommands\fR option is empty, the ensemble subcommand names