Whole document tree


www.fifi.org
    Documentation
        Manpages
        GNU Info
        Debian document tree
        Whole document tree
    Trigance web page
    Public services
    User info
    Mailing lists
    Secure server
    Multilingual usage
 

Copyright (C) 2000-2012
Philippe Troin
<webmaster@fifi.org>.

Validate HTML
Validate CSS

    

Whole document tree

AreaSpec
Guide to the DocBook DTD
PrevNext

AreaSpec

Name

AreaSpec -- Collection of regions in a graphic or code example

Content Model

  (Area | AreaSet)+

Attributes

This element has common and Role attributes.

NameValue(s)TypeDefault Value
OtherUnitsNAME#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, ScreenCO.

Children

AreaSpec contains these elements: Area, 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>
PrevHomeNext
AreaSetUpArg