3.2.6.2.15 groupcomp

The <groupcomp> element is part
of the subset of elements that define syntax diagrams in DITA. A group
is a logical set of pieces of syntax that go together. The group composite
means that the items that make up the syntax diagram will be formatted
close together rather than being separated by a horizontal or vertical
line, which is the usual formatting method. This element
is part of the DITA programming domain, a special set of DITA elements
designed to document programming tasks, concepts, and reference information.

Contains

Note: These models represent only the default document types distributed by OASIS.
Actual content models will differ with each new document type.

Attributes

Name

Description

Data Type

Default Value

Required?

importance

The attribute indicates whether this item in a syntax
diagram is
optional,
required, or
default. Output processors may indicate this
designation in a generated diagram. See
Using the -dita-use-conref-target value for more information
on the -dita-use-​conref-​target value.

optional | required | default |
-dita-use-​conref-​target

#IMPLIED

No

props

Root
attribute from which new metadata attributes can be specialized.
This is a property attribute which supports conditional
processing for filtering or flagging.If
no value is specified, but the attribute is specified on an ancestor within a
map or within the related-links section, the value will cascade from the
closest ancestor.The attribute takes a space-delimited set of values.
However, when acting as a container for generalized attributes, the content
model will be more complex; see
Attribute generalization for
more details.

CDATA

#IMPLIED

No

base

A
generic attribute that has no specific purpose. It is intended to act as a base
for specialized attributes that have a simple value syntax like the conditional
processing attributes (one or more alphanumeric values separated by
whitespace), but is not itself a filtering or flagging attribute.
The attribute takes a space-delimited set of values.
However, when acting as a container for generalized attributes, the content
model will be more complex; see
Attribute generalization for
more details.

CDATA

#IMPLIED

No

platform

Indicates operating system and hardware.
This is a property attribute which supports conditional
processing for filtering or flagging.If
no value is specified, but the attribute is specified on an ancestor within a
map or within the related-links section, the value will cascade from the
closest ancestor.The attribute takes a space-delimited set of
values.

CDATA

#IMPLIED

No

product

Contains the name of the product to which the element
applies.
This is a property attribute which supports conditional
processing for filtering or flagging.If
no value is specified, but the attribute is specified on an ancestor within a
map or within the related-links section, the value will cascade from the
closest ancestor.The attribute takes a space-delimited set of
values.

CDATA

#IMPLIED

No

audience

Indicates the intended audience for the element.
This is a property attribute which supports conditional
processing for filtering or flagging.If
no value is specified, but the attribute is specified on an ancestor within a
map or within the related-links section, the value will cascade from the
closest ancestor.The attribute takes a space-delimited set of
values.

CDATA

#IMPLIED

No

otherprops

This attribute can be used for any other properties that
might be needed to describe an audience, or to provide selection criteria for
the element. Alternatively, the props attribute may be specialized to provide a
new metadata attribute instead of using the general otherprops attribute.
This is a property attribute which supports conditional
processing for filtering or flagging.If
no value is specified, but the attribute is specified on an ancestor within a
map or within the related-links section, the value will cascade from the
closest ancestor.The attribute takes a space-delimited set of
values.

CDATA

#IMPLIED

No

rev

Indicates a revision level of an element that identifies
when the element was added or modified. It
may be used to flag outputs when it matches a run-time
parameter;
it cannot be used for filtering. It is
not sufficient to be used for version control.If
no value is specified, but the attribute is specified on an ancestor within a
map or within the related-links section, the value will cascade from the
closest ancestor.