implicitAnnouncementGrouper object | msg_neu.t[5465]

Implied action announcement grouper. This takes a list of ImplicitActionAnnouncement reports and returns a single message string describing the entire list of actions.

`implicitAnnouncementGrouper : object`

Superclass Tree (in declaration order)

`implicitAnnouncementGrouper`
`object`

Summary of Properties

`keepAllFailures`

Summary of Methods

`compositeMessage`

Properties

`keepAllFailures` | `msg_neu.t[5487]`

Configuration option: keep all failures in a list of implied announcements. If this is true, then we'll write things like "trying to unlock the door and then open it"; if nil, we'll instead write simply "trying to unlock the door".

By default, we keep only the first of a group of failures. A group of failures is always recursively related, so the first announcement refers to the command that actually failed; the rest of the announcements are for the enclosing actions that triggered the first action. All of the enclosing actions failed as well, but only because the first action failed.

Announcing all of the actions is too verbose for most tastes, which is why we set the default here to nil. The fact that the first action in the group failed means that we necessarily won't carry out any of the enclosing actions, so the enclosing announcements don't tell us much. All they really tell us is why we're running the action that actually failed, but that's almost always obvious, so suppressing them is usually fine.

Methods

`compositeMessage (lst)` | `msg_neu.t[5490]`

build the composite message

TADS 3 Library Manual
Generated on 5/16/2013 from TADS version 3.1.3