Design examples

You can define an element only once. Use $name to specify a position within a specialized container element that refers to an element defined elsewhere within the current module or that refers to a set defined in any module.

max-base

Preserve as much base content as possible.

This value is the default when dbexContent isn't specified and the content doesn't include any example elements with specialized names or explicit occurrence.

min-base

Preserve as little base content as possible. If all of the base content is optional and no content is specified, this value results in empty content.

This value is the default when dbexContent isn't specified and the content includes example elements with specialized names or explicit occurrence.

Example elements may have an occurrence only within a specialized container element.

-

base-occurs

The same occurrence as the corresponding position within the content of the base element for the specialized container element.

This value is the default when dbexOccurs isn't specified on the example element.

?

optional

.

required

*

any

+

some

An explicit occurrence of the position within the specialized container element.

!

none

Where dbexContent specifies max-base, omit the content of the base position within the specialized container element.

...

base-list

Include as many base positions as possible between the preceding and following positions (those with specialized names or explicit occurrence) within the specialized container element.

define

Define specialized elements from the current example element or its contents at any depth for later reference but don't add them to the specialized container element.

#

ignore

Treat the example element and its contents as a comment.

Also specifies the last member of a set defined as a list and the members of a set defined within a container.

member-set

Allowed but not required on members of a set defined as a list.

Required for members of a set defined within a container element.

end-set

Terminates a set defined with an explicit list.

append-set

Terminates a set that defined with a list of specialized elements added to the base set for the position. Note: Defining a set by appending specialized elements to a base set is unstable.

-

base-occurs

?

optional

.

required

*

any

+

some

Specifies the occurrence of a set defined as a list within a specialized container element.

The occurrence for a set can be specified only on the last member of the set.

!

none

When appending to a base set, drops the example element from the list of appended elements. Note: Dropping base members from an extended set is unstable.

define-set

Defines a set for later reference from contained example elements at any depth that have a dbexOccurs value of member-set. The dbexSet attribute must be set to a name. Note: Defining sets by containment is unstable.

Alternatively, specifies an attribute restriction. The restriction applies to the attributes of the example element that have values. If the dbexAttributes attribute specifies a restriction, no other attribute of the example element can specify a restriction. To apply the restriction to a single attribute, the dbexAttributes attribute must start with a name subfield that identifies the restricted attribute.

The attribute restriction applies to the specialized element defined or referenced with the dbexName attribute or to the members of the set containing the attribute restriction or referenced with the dbexName. The element or set must be defined within the same module that specifies the restriction.

max-base

Preserve as many base attributes as possible.

Attributes that aren't dropped explicitly are preserved. Attributes without a restriction are preserved unchanged.

This value is the default when dbexAttributes isn't specified.

min-base

Preserve as few base attributes as possible. If all of the base attributes are optional and no values or restrictions are specified, this value results in an empty attribute list.

Attributes without a value or restriction are dropped implicitly. Attributes with a value and no restriction are preserved unchanged.

define-attribute

Restricts attributes. Note: Restricting attributes by reference or for a set is unstable.