Whole document tree
CalloutList
Description
A collection of callout descriptions linked to regions in a graphic or code example. CalloutList has common attributes.
Parents
These elements contain CalloutList: Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Caution, Chapter, Dedication, Example, Footnote, GlossDef, GlossDiv, Glossary, GraphicCO, Highlights, Important, Index, InformalExample, LegalNotice, ListItem, MsgExplan, MsgText, Note, Para, PartIntro, Preface, Procedure, ProgramListingCO, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, ScreenCO, Sect1, Sect2, Sect3, Sect4, Sect5, SetIndex, Sidebar, SimpleSect, Step, Tip, Warning, entry.
Children
CalloutList contains these elements: Callout, Title, TitleAbbrev.
In some contexts, additional elements may be allowed by inclusions in parent elements. Similarly, in some contexts, some of these elements may be invalid due to exclusions in parent elements.
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>
<programlistingco>
<areaspec>
<area id="ex.plco.ret" coords=12>
<area id="ex.plco.dest" coords=12>
<areaset id="ex.plco.const" coords="">
<area id="ex.plco.c1" coords=4>
<area id="ex.plco.c2" coords=8>
</areaset>
</areaspec>
<programlisting>
sub do_nothing_useful {
my($a, $b, $c);
$a = new A;
$a->does_nothing_either();
$b = new B;
$c = "frog";
return ($a, $c);
}
</programlisting>
<calloutlist>
<callout arearefs="ex.plco.const">
<para>
These are calls to the constructor <function>new</function>
in the object classes.
</para>
</callout>
<callout arearefs="ex.plco.ret">
<para>
This function returns a two-element list.
</para>
</callout>
<callout arearefs="ex.plco.dest">
<note>
<para>
The <emphasis>destructor</emphasis> (<function>DESTROY</function>)
for the object <literal>$b</literal> will be called automatically for
this object as there can be no other references to it outside
this function.
</para>
</note>
</callout>
</calloutlist>
</programlistingco>