— part of check-in
on branch trunk
* Renamed 'ehandler' to intercept. Documented the change. Kept the old
name around, deprecated it.
* Renamed 'shandler' to custom-setup, and documented it. Extended the
implementation to support a list of customizations, instead of a
* Fixed handling of *prefix* for --help. Code wrongly extended the
local copy of the block, instead of the root copy.
Updated docs, change information.
Regenerated the embedded docs.
[para] The officer DSL is implemented in [package cmdr::officer].
[para] While the specification is supplied with the instance
constructor it is not processed immediately, but saved for when it is
[para] The internal instance method [method Setup] is called at all
places requiring access to the specification and processes it (once,
on first call) to provide the necessary in-memory structures.
[para] The DSL commands map to instance methods as shown below:
[def [cmd alias]] [method Alias]
[def [cmd common]] [package cmdr::actor] [method set]
[def [cmd custom-setup]] [method custom-setup]
[def [cmd default]] [method Default]
[def [cmd description]] [package cmdr::actor] [method description:]
[def [cmd ehandler]] See [cmd intercept]. [emph Deprecated].
[def [cmd intercept]] [method intercept]
[def [cmd officer]] [method Officer], forward to [method DefineAction]
[def [cmd private]] [method Private], forward to [method DefineAction]
[def [cmd undocumented]] [package cmdr::actor] [method undocumented]