<?xml version="1.0" encoding="utf-8"?>
<article xmlns="http://docbook.org/ns/docbook" version="5.0">
   <info>
      <title>Unit Test: calloutlist.003</title>
      <author>
         <personname>
            <firstname>Benoit</firstname>
            <surname>Guillon</surname>
         </personname>
      </author>
   </info>
   <section>
      <title>Callouts</title>
      <section>
         <title>Embedded <tag>co</tag>s</title>
         <programlisting>  &lt;refentry&gt;
    &lt;info&gt;
      &lt;date&gt;2003-10-20&lt;/date&gt; <co linkends="V1690_date" xml:id="V1690_date-co"/>
    &lt;/info&gt;
    &lt;refmeta&gt;
      &lt;refentrytitle&gt;gtk-options&lt;/refentrytitle&gt; <co linkends="V1690_title" xml:id="V1690_title-co"/>
      &lt;manvolnum&gt;7&lt;/manvolnum&gt; <co linkends="V1690_manvolnum" xml:id="V1690_manvolnum-co"/>
      &lt;refmiscinfo class="source-name"&gt;GTK+&lt;/refmiscinfo&gt; <co linkends="V1690_source-name" xml:id="V1690_source-name-co"/>
      &lt;refmiscinfo class="version"&gt;1.2&lt;/refmiscinfo&gt; <co linkends="V1690_version" xml:id="V1690_version-co"/>
      &lt;refmiscinfo class="manual"&gt;GTK+ User's Manual&lt;/refmiscinfo&gt; <co linkends="V1690_manual" xml:id="V1690_manual-co"/>
    &lt;/refmeta&gt;
    &lt;refnamediv&gt;
      &lt;refname&gt;gtk-options&lt;/refname&gt;
      &lt;refpurpose&gt;Standard Command Line Options for GTK+ Programs&lt;/refpurpose&gt;
    &lt;/refnamediv&gt;
    &lt;refsect1&gt;
      &lt;title&gt;Description&lt;/title&gt;
      &lt;para&gt;This manual page describes the command line options, which
      are common to all GTK+ based applications.&lt;/para&gt;
    &lt;/refsect1&gt;
  &lt;/refentry&gt;
</programlisting>
         <calloutlist>
            <callout xml:id="V1690_date" arearefs="V1690_date-co">
               <para>Sets the <quote>date</quote> part of the header/footer.</para>
            </callout>
            <callout xml:id="V1690_title" arearefs="V1690_title-co">
               <para>Sets the <quote>title</quote> part.</para>
            </callout>
            <callout xml:id="V1690_manvolnum" arearefs="V1690_manvolnum-co">
               <para>Sets the <quote>section</quote> part.</para>
            </callout>
            <callout xml:id="V1690_source-name" arearefs="V1690_source-name-co">
               <para>Sets the <quote>source name</quote> part.</para>
            </callout>
            <callout xml:id="V1690_version" arearefs="V1690_version-co">
               <para>Sets the <quote>version</quote> part.</para>
            </callout>
            <callout xml:id="V1690_manual" arearefs="V1690_manual-co">
               <para>Sets the <quote>manual</quote> part.</para>
            </callout>
         </calloutlist>
         <para>
Another <tag>screen</tag> including <tag>coref</tag> too. The
first <tag>coref</tag> is not valid, the second one is valid. It checks
also that several items in co/@linkends are correctly handled.
</para>
         <screen> Volume in drive C is SYSTEM         Serial number is 2350:717C
 Directory of  C:\

10/17/97   9:04         &lt;DIR&gt;    bin
10/16/97  14:11         &lt;DIR&gt;    DOS <co linkends="firstco lastco" xml:id="dos"/>
10/16/97  14:40         &lt;DIR&gt;    Program Files
10/16/97  14:46         &lt;DIR&gt;    TEMP <coref linkend="unknown"/>
10/17/97   9:04         &lt;DIR&gt;    tmp <coref linkend="dos"/>
10/16/97  14:37         &lt;DIR&gt;    WINNT
10/16/97  14:25             119  AUTOEXEC.BAT <co xml:id="autoexec.bat" linkends="startup"/>
 2/13/94   6:21          54,619  COMMAND.COM <co xml:id="command.com" linkends="startup"/>
10/16/97  14:25             115  CONFIG.SYS <co xml:id="config.sys"/>
11/16/97  17:17      61,865,984  pagefile.sys
 2/13/94   6:21           9,349  WINA20.386 <co xml:id="wina20.386"/>
         </screen>
         <calloutlist>
            <callout xml:id="firstco" arearefs="dos">
               <para>
  This directory holds <trademark>MS-DOS</trademark>, the
  operating system that was installed before <trademark>Windows
  NT</trademark>.
  </para>
            </callout>
            <callout arearefs="autoexec.bat command.com config.sys" xml:id="startup">
               <para>
  System startup code for DOS.
  </para>
            </callout>
            <callout xml:id="lastco" arearefs="wina20.386">
               <para>
  Some sort of <trademark>Windows 3.1</trademark> hack for some 386 processors,
  as I recall.
  </para>
            </callout>
         </calloutlist>
      </section>
      <section>
         <title>Programlistingco</title>
         <para>This case checks that spaces are added to reach the expected
column.</para>
         <programlistingco>
            <areaspec>
               <area coords="2 55" xml:id="hermite1"/>
               <area coords="4 55" xml:id="hermite2"/>
            </areaspec>
            <programlisting>This is a line
This is another line
This is a third lien


...
</programlisting>
            <calloutlist>
               <callout arearefs="hermite1 hermite2">
                  <para>
here <function>HermiteNormalFormIntegerMat</function>
is used
</para>
               </callout>
            </calloutlist>
         </programlistingco>
         <para>This programlistingco checks that you can put several markups at different
column positions into the same line, and that several markups with no column
specification are both put at the end of the line. The special case of a markup at
the end of the last line is checked too.</para>
         <programlistingco>
            <areaspec>
               <area coords="2 10" xml:id="pos10"/>
               <area coords="2 12" xml:id="pos12"/>
               <area coords="2" xml:id="posend1"/>
               <area coords="2" xml:id="posend2"/>
               <area coords="8" xml:id="poslast"/>
            </areaspec>
            <programlisting>This is a line
This is another line
This is a third lien


...
The very last line</programlisting>
            <calloutlist>
               <callout arearefs="pos10 pos12">
                  <para>
here <function>HermiteNormalFormIntegerMat</function>
is used
</para>
               </callout>
            </calloutlist>
         </programlistingco>
      </section>
   </section>
</article>
