diff options
| author | dkf <donal.k.fellows@manchester.ac.uk> | 2012-05-25 14:52:29 (GMT) |
|---|---|---|
| committer | dkf <donal.k.fellows@manchester.ac.uk> | 2012-05-25 14:52:29 (GMT) |
| commit | c0be36ea12bff6fe98ce0406dd19e708ddc89906 (patch) | |
| tree | cf2dc0c375b1925ed633b5f9dfbb521cfebb6e67 | |
| parent | 423017faed3aa258b3fa9c04cf9c6f5289d355a8 (diff) | |
| parent | b317e4d6a30ce58b28482a6b884f3aed5a3f05f7 (diff) | |
| download | tcl-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.
| -rw-r--r-- | ChangeLog | 4 | ||||
| -rw-r--r-- | doc/Ensemble.3 | 2 | ||||
| -rw-r--r-- | doc/namespace.n | 5 |
3 files changed, 10 insertions, 1 deletions
@@ -1,5 +1,9 @@ 2012-05-25 Donal K. Fellows <dkf@users.sf.net> + * doc/namespace.n, doc/Ensemble.3: [Bug 3528418]: Document what is + going on with respect to qualification of command prefixes in ensemble + subcommand maps. + * generic/tclIO.h (SYNTHETIC_EVENT_TIME): Factored out the definition of the amount of time that should be waited before firing a synthetic event on a channel. 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 |