[Prev] [Next]

AreaSet

Name

Synopsis

  Area+

Attributes

This element has common and Role attributes.

Name	Value(s)	Type	Default Value
Coords	CDATA	#REQUIRED
Label	CDATA	#IMPLIED
OtherUnits	NAME	#IMPLIED
Units	(CALSPair |LineColumn |LineRange |LineColumnPair |Other)	#IMPLIED

Tag Minimization

Both the start- and end-tags are required for this element.

Description

A set of related Areas in a graphic or code example, which should be associated with the same callout description. AreaSet contains one or more Areas. It has optional Label, Units, and OtherUnits attributes, a required Coords attribute, and common attributes with ID required.

Parents

AreaSet occurs in AreaSpec.

Children

AreaSet contains Area.

Attributes

Label

Label holds an identifying number or string to be output in some manner when the element it is applied to is rendered.

Units

The default is implementation-specific and is dependent on the parent element (CALSPair for GraphicCO, LineColumn for ProgramListingCO and ScreenCO).

OtherUnits

OtherUnits holds the name of user-defined units to be used instead of a conventional selection from the values of the Units attribute.

Coords

Coords gives the coordinates for the Area or AreaSet in the format defined by the Units or OtherUnits attributes.

Examples

<PROGRAMLISTINGCO>
<AREASPEC UNITS="LINECOLUMN">
<AREA ID="sco123" COORDS="1 1">
<AREA ID="sco124" COORDS="6 9">
</AREASPEC>
<PROGRAMLISTING>
<SYSTEMITEM CLASS="PROMPT">%</SYSTEMITEM> <USERINPUT>make install</USERINPUT>
install -c -m 0644 rgb.txt /usr/lib/X11
install -c -m 0644 rgb.dir /usr/lib/X11
install -c -m 0644 rgb.pag /usr/lib/X11
install -c -s showrgb /usr/lib/X11
install in ./rgb done
</PROGRAMLISTING>
<CALLOUTLIST>
<TITLE>Comments on the Screen Shown Above</TITLE>
<CALLOUT AREAREFS="sco123">
<PARA>Note % prompt.</PARA>
</CALLOUT>
<CALLOUT AREAREFS="sco124">
<PARA>Note use of install without flag.
</PARA>
</CALLOUT>
</CALLOUTLIST>
</PROGRAMLISTINGCO>

[Prev] Area
[Next] AreaSpec
[Reference Home] [Davenport Group Home]