Artifact 47ebd7eacbeaf7bc4f5ed92dbc27472f01f50bda:

• File doc/parts/dev_dsl_officer.inc — part of check-in [cabf535e47] at 2016-06-29 07:54:42 on branch trunk — officers/private * 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 single. * 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. (user: aku size: 1106)

[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
actually needed.

[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:

[list_begin definitions]
[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]
[list_end]