alan-if / alan-docs

Alan IF Documentation Project

Home Page:https://git.io/alan-docs

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Manual: Explain VERB Definitions With Multiple IDs

tajmone opened this issue · comments

In §3.11. VERBs, the Manual doesn't go into much details about how VERB definitions with multiple IDs work:

Verb take, get
  ...
End Verb take.

[...]

If there is more than one identifier in the list, as in the example above, this can be viewed as a shorthand for declaring identical checks and bodies for all the verbs in the list. This will create synonymous actions for different verbs at the level of the verb declaration. They may differ in implementation at other places, i.e. if they are declared in the same verb declaration on one level in an inheritance tree, they can still have different bodies on another level.

I think that this topic deserves a sub-section of its own:

  • Section title? — what's this called, "multiverb definitions"?
  • What are the prerequisites for defining multiple verbs at once?
    • Syntax compatibility criteria?
    • Parameter must be same named?
    • Other?
  • Provide a new and better example.