pub enum Conformance {
Mandatory,
Optional,
Provisional,
Deprecated,
Disallowed,
Described,
}Expand description
What the specification says about an element’s presence.
Four of the five are decisions; Described is the refusal to make one, and
Cluster::validate is where all five are acted on.
Variants§
Mandatory
M — the element SHALL be present.
Optional
O — the element MAY be present.
Provisional
P — provisional. Not certifiable, and may change in a dot revision.
Three lists say what is provisional: Core §2.13, and the Application Cluster and Device
Library specifications’ own. A device may serve one, so this behaves as
Optional when the provisional feature is on — and
Cluster::validate reports
Defect::Provisional when it is not, because a
certifiable build is the default build.
Deprecated
D — deprecated. Present for compatibility with an earlier revision, and not to be
implemented in anything new.
Disallowed
X — the element SHALL NOT be present.
Described
desc — the rule is prose the XML could not express, so the specification’s own words
decide. Neither permitted nor forbidden mechanically; a validator must not guess.