[Bug 3528418]: Document what is going on with respect to qualification of

command prefixes in ensemble subcommand maps.

2 files changed, 6 insertions, 1 deletions

diff --git a/doc/Ensemble.3 b/doc/Ensemble.3
index 5a5842d..bc743c2 100644
--- a/doc/Ensemble.3
+++ b/doc/Ensemble.3
@@ -148,6 +148,8 @@ code (TCL_OK, or TCL_ERROR 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
 \fBsubcommand list\fR (read-write)
 A list of all the subcommand names for the ensemble, or NULL if this
diff --git a/doc/namespace.n b/doc/namespace.n
index ddf7b51..8b26786 100644
--- a/doc/namespace.n
+++ b/doc/namespace.n
@@ -714,7 +714,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