DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

stepalternatives

stepalternatives — Alternative steps in a procedure.

Synopsis

stepalternatives ::=

  • Sequence of:
    • info(db.titleforbidden.info)
    • One or more of:

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • performance (enumeration)
    • “optional”
    • “required”

Description

Most steps in a procedure are sequential: do the first, then the second, then the third. Sometimes procedures provide an explicit ordering: do step 7 next.

The stepalternatives element was added to support the semantics of alternative steps: perform exactly one of the following steps. The reader is presumably given some criteria for deciding which one to choose, but the significant difference is that only one of the steps is performed.

Processing expectations

Formatted as a displayed block.

Attributes

Common attributes and common linking attributes.

performance

Specifies if the content is required or optional.

Enumerated values:
“optional”

The content describes an optional step or steps.

“required”

The content describes a required step or steps.

Parents

These elements contain stepalternatives: step.

Children

The following elements occur in stepalternatives: info (db.titleforbidden.info), step.