[Prev] [Next]

AreaSpec

Name

Synopsis

  (Area | AreaSet)+

Attributes

This element has common and Role attributes.

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

Tag Minimization

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

Description

Collection of regions and/or multiple-region groups in a graphic or code example that are associated with callout descriptions. AreaSpec contains one or more Areas or AreaSets. It has common attributes and optional Units and OtherUnits attributes.

Parents

These elements contain AreaSpec: GraphicCO, ProgramListingCO, and ScreenCO.

Children

AreaSpec contains these elements: Area, and AreaSet.

Attributes

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.

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>

<GRAPHICCO>
<AREASPEC UNITS="CALSPAIR">
<AREA ID="co123" LABEL="1" COORDS="100,100 550,935">
<AREA ID="co124" LABEL="2" COORDS="1500,1500 2175,3184">
</AREASPEC>
<GRAPHIC FILEREF="gr061ch05t2.gif" FORMAT="GIF"></GRAPHIC>
<CALLOUTLIST>
<TITLE>Comments on the Picture Above</TITLE>
<CALLOUT AREAREFS="co123">
<PARA>A bit too far down and left</PARA>
</CALLOUT>
<CALLOUT AREAREFS="co124">
<PARA>This is the most interesting part of the diagram.
</PARA>
</CALLOUT>
</CALLOUTLIST>
</GRAPHICCO>

<SCREENCO>
<AREASPEC UNITS="LINECOLUMN">
<AREA ID="sco123" COORDS="1 1">
<AREA ID="sco124" COORDS="6 9">
</AREASPEC>
<SCREEN ID="SC-1015-12-24" WIDTH="44">
<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
</SCREEN>
<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>
</SCREENCO>

[Prev] AreaSet
[Next] Arg
[Reference Home] [Davenport Group Home]