doc/xslt/tests/refentry.007.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   3           "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
   4 <book>
   5 <bookinfo>
   6 <title>Unit Test: refentry.007</title>
   7 <releaseinfo role="CVS">$Id: refentry.007.xml 7282 2007-08-23 09:27:01Z xmldoc $</releaseinfo>
   8 <author><firstname>Norman</firstname><surname>Walsh</surname>
   9         <affiliation><address><email>ndw@nwalsh.com</email></address></affiliation>
  10 </author>
  11 </bookinfo>
  12 <reference>
  13 <title>Reference</title>
  14 <refentry>
  15   <refentryinfo>
  16     <authorgroup>
  17       <author>
  18         <firstname>Norman</firstname><surname>Walsh</surname>
  19         <email>ndw@nwalsh.com</email>
  20         <personblurb>
  21           <para>Wrote the original version of this document.</para>
  22         </personblurb>
  23       </author>
  24       <editor>
  25         <contrib>Added a bunch of test cases.</contrib>
  26         <firstname>Michael(tm)</firstname><surname>Smith</surname>
  27         <email>smith@sideshowbarker.net</email>
  28       </editor>
  29     </authorgroup>
  30     <copyright>
  31       <year>2003</year>
  32       <holder>Norman Walsh</holder>
  33     </copyright>
  34     <copyright>
  35       <year>2006</year>
  36       <holder>Michael(tm) Smith</holder>
  37     </copyright>
  38     <legalnotice>
  39       <para>This file is a product of the DocBook Project.</para>
  40     </legalnotice>
  41     <legalnotice>
  42       <para>Share and share alike.</para>
  43     </legalnotice>
  44   </refentryinfo>
  45 <refnamediv>
  46 <refname>FirstName</refname>
  47 <refname>SecondName</refname>
  48 <refpurpose>Purpose for FirstName</refpurpose>
  49 </refnamediv>
  50
  51 <refnamediv>
  52 <refname>ThirdName</refname>
  53 <refpurpose>Purpose for ThirdName</refpurpose>
  54 </refnamediv>
  55
  56 <refsynopsisdiv>
  57   <?dbfunclist ?>
  58   <funcsynopsis>
  59     <!-- * Yes, friend, Funcsynopsis is a verbatim -->
  60     <funcsynopsisinfo
  61 >#include &lt;varargs.h&gt;
  62 #include &lt;mouteyh.h&gt;
  63 #include &lt;qlmppzj.h&gt;</funcsynopsisinfo>
  64     <funcprototype>
  65       <funcdef><type>float</type> <function>rand</function></funcdef>
  66       <void/>
  67     </funcprototype>
  68
  69     <funcprototype>
  70       <funcdef>int <function>max</function></funcdef>
  71       <varargs/>
  72     </funcprototype>
  73
  74     <funcprototype>
  75       <funcdef>int <function>idiv</function></funcdef>
  76       <paramdef><type>int</type> <parameter>n</parameter></paramdef>
  77       <paramdef><type>int</type> <parameter>m</parameter></paramdef>
  78     </funcprototype>
  79   </funcsynopsis>
  80
  81   <para>Another.</para>
  82
  83   <funcsynopsis>
  84     <funcprototype>
  85       <funcdef>void <function>qsort</function></funcdef>
  86       <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
  87       <paramdef>int <parameter>left</parameter></paramdef>
  88       <paramdef>int <parameter>right</parameter></paramdef>
  89       <paramdef>int (*<parameter>comp</parameter>)
  90       <funcparams>void *, void *</funcparams></paramdef>
  91     </funcprototype>
  92   </funcsynopsis>
  93
  94   <funcsynopsis>
  95     <funcprototype>
  96       <funcdef>int <function>foo_frob_something</function></funcdef>
  97       <paramdef>foo_sometype1 <parameter>foo_frob_parm1</parameter></paramdef>
  98       <paramdef>foo_sometype1 <parameter>foo_frob_parm2</parameter></paramdef>
  99       <paramdef>foo_sometype1 <parameter>foo_frob_parm3</parameter></paramdef>
 100       <paramdef><type>int</type> (* <parameter>parm4</parameter> )
 101       <funcparams>int a, int b, int c</funcparams>
 102       </paramdef>
 103       <paramdef>foo_sometype1 <parameter>foo_frob_parm5</parameter></paramdef>
 104     </funcprototype>
 105
 106     <funcprototype>
 107       <funcdef>int <function>foo_frob_something</function></funcdef>
 108       <paramdef>foo_sometype1 <parameter>foo_frob_parm1</parameter></paramdef>
 109       <paramdef>foo_sometype1 <parameter>foo_frob_parm2</parameter></paramdef>
 110       <paramdef>foo_sometype1 <parameter>foo_frob_parm3</parameter></paramdef>
 111       <paramdef><type>int</type> (* <parameter>parm4</parameter> )
 112       <funcparams>int a, int b, int c</funcparams>
 113       </paramdef>
 114       <paramdef>foo_sometype1 <parameter>foo_frob_parm5</parameter></paramdef>
 115     </funcprototype>
 116   </funcsynopsis>
 117 </refsynopsisdiv>
 118
 119 <refsect1>
 120 <title>Description</title>
 121 <para>This is a minimal RefEntry.</para>
 122
 123 <para>The following is a Variablelist with a title.
 124 <variablelist>
 125   <title>My variablelist</title>
 126   <varlistentry>
 127     <term>varlistentry term 1</term>
 128     <listitem><para>some listitem text</para></listitem>
 129   </varlistentry>
 130   <varlistentry>
 131     <term>varlistentry term 2</term>
 132     <listitem><para>some more listitem text</para></listitem>
 133   </varlistentry>
 134 </variablelist>
 135 </para>
 136 <refsect2>
 137 <title>Subsection</title>
 138 <para>This is a minimal RefEntry.</para>
 139
 140 <para>The following is a Variablelist with a title and a nested variablelist
 141   <glosslist>
 142     <title>My glosslist</title>
 143   <glossentry>
 144     <glossterm>glossentry term 1</glossterm>
 145     <glossdef><para>some glossdef text</para></glossdef>
 146   </glossentry>
 147   <glossentry>
 148     <glossterm>glossentry term 2</glossterm>
 149     <glossdef>
 150       <variablelist>
 151         <varlistentry>
 152           <term>nested variablelist term 1</term>
 153           <listitem><para>some variablelist text</para></listitem>
 154         </varlistentry>
 155         <varlistentry>
 156           <term>nested variablelist term 2</term>
 157           <listitem><para>some more variablelist text</para></listitem>
 158         </varlistentry>
 159       </variablelist>
 160     </glossdef>
 161   </glossentry>
 162   </glosslist>
 163 </para>
 164
 165 <refsect3>
 166 <title>Sub-subsection</title>
 167 <para>This is a minimal RefEntry.</para>
 168 </refsect3>
 169 </refsect2>
 170 </refsect1>
 171
 172 <refsect1>
 173 <title>More Description</title>
 174 <para>This is a not-so minimal RefEntry.</para>
 175 <screen>
 176 This is a screen [break here]
 177 that starts with a line of space. [break here]
 178 And it ends with a line of space.
 179 </screen>
 180
 181 <para>normal paragraph here</para>
 182
 183 <screen>This is a screen [break here]
 184 that does not start with a line of space. [break here]
 185 And does not end with a line of space.</screen>
 186
 187 <para>This is a normal paragraph that contains a screen.
 188 <screen>This is a screen within a normal paragraph [break here]
 189 that does not start with a line of space. [break here]
 190 And does not end with a line of space but is followed
 191 by a line of space.</screen>
 192 </para>
 193
 194 <para>This is another  normal paragraph that contains a screen.
 195 <screen>This is a screen within a normal paragraph [break here]
 196 that does not start with a line of space. [break here]
 197 And does not end with a line of space and is not followed
 198 by a line of space.</screen></para>
 199
 200 <para>This is another  normal paragraph that contains a screen.
 201 <screen>
 202 This is a screen within a normal paragraph [break here]
 203 that starts with a line of space. [break here]
 204 And ends with a line of space but is not followed by a line of space.
 205 </screen></para>
 206
 207 <para>This is another  normal paragraph that contains a screen.
 208 <screen>
 209 This is a screen within a normal paragraph [break here]
 210 that starts with a line of space. [break here]
 211 And ends with a line of space and is followed by a line of space.
 212 </screen>
 213 </para>
 214
 215 <para>This is another  normal paragraph that contains a screen.
 216 <screen>
 217
 218 This is a screen within a normal paragraph [break here]
 219 that starts with a 2 lines of space. [break here]
 220 And ends with 3 lines of space and is followed by a line of space.
 221
 222
 223 </screen>
 224 </para>
 225
 226 <para>This paragraph contains an itemizedlist with a title. The title
 227 is “Mrignkwolmcng”.
 228 <orderedlist>
 229   <title>Mrignkwolmcng</title>
 230   <listitem>
 231     <para>itemizedlist listitem 1</para>
 232   </listitem>
 233   <listitem>
 234     <para>itemizedlist listitem 2</para>
 235   </listitem>
 236 </orderedlist>
 237
 238 This is some useless text that follows the “Mrignkwolmcng” orderedlist
 239 in the same para.</para>
 240
 241 <para>The following is a Variablelist with a title and with a nested itemizedlist.
 242 <variablelist>
 243   <title>My variablelist</title>
 244   <varlistentry>
 245     <term>varlistentry term 1</term>
 246     <listitem>
 247       <itemizedlist>
 248         <title>nested itemizedlist</title>
 249         <listitem>
 250           <para>itemizedlist listitem 1</para>
 251         </listitem>
 252         <listitem>
 253           <para>itemizedlist listitem 2</para>
 254         </listitem>
 255       </itemizedlist>
 256     </listitem>
 257   </varlistentry>
 258   <varlistentry>
 259     <term>varlistentry term 2</term>
 260     <listitem><para>some more listitem text</para></listitem>
 261   </varlistentry>
 262 </variablelist>
 263 </para>
 264
 265 <para>The following is a Variablelist with a title and with a
 266 nested Varlistentry that contains multiple Terms
 267 <variablelist>
 268   <title>My nested-multi-term-per-varlistentry variablelist</title>
 269   <varlistentry>
 270     <term>Varlistentry term 1</term>
 271     <listitem>
 272       <variablelist>
 273         <varlistentry>
 274           <term>  varlistentry term 1.1</term>
 275           <term>varlistentry term 1.2  </term>
 276           <term>varlistentry         term 1.3</term>
 277           <listitem><para>All 'bout terms 1.1, 1.2, and 1.3</para>
 278           </listitem>
 279         </varlistentry>
 280       </variablelist>
 281     </listitem>
 282   </varlistentry>
 283   <varlistentry>
 284     <term>varlistentry term 2</term>
 285     <listitem><para>some more listitem text</para></listitem>
 286   </varlistentry>
 287 </variablelist>
 288 </para>
 289
 290 <refsect2>
 291 <title>Subsection</title>
 292 <para>This is a minimal RefEntry.</para>
 293 </refsect2>
 294 </refsect1>
 295
 296 <refsect1>
 297 <title>Even More Description</title>
 298 <para>This is an even less minimal RefEntry.</para>
 299
 300 <para>This is a paragraph. It contains the following segmentedlist,
 301 titled “Gibbererish”, with several segtitle elements.
 302 <segmentedlist>
 303   <title>Gibbererish</title>
 304   <segtitle>Floober</segtitle>
 305   <segtitle>Buugler</segtitle>
 306   <segtitle>Sstangooo</segtitle>
 307   <segtitle>Borobinda</segtitle>
 308   <seglistitem>
 309   <seg>Bamalalaboonda Bamalalaboonda Bamalalaboonda Bamalalaboonda Bamalalaboonda Bamalalaboonda</seg>
 310   <seg>Mondorotoluafu</seg>
 311   <seg>Ganafutralinga</seg>
 312   <seg>Patagularamakundra</seg>
 313   </seglistitem>
 314   <seglistitem>
 315   <seg>Cadraracondar</seg>
 316   <seg>Hentirotomaambu</seg>
 317   <seg>BdomentriolaiaBdomentriolaiaBdomentriolaia</seg>
 318   <seg>Candamalaturuanio</seg>
 319   </seglistitem>
 320 </segmentedlist>
 321 This is some text that follows the segementedlist within the same
 322 paragraph. The next part of this same paragraph is an
 323 <sgmltag>important</sgmltag> admonition.
 324 <important>
 325   <para>It is very important that you read this. That’s why it stands
 326   out the way that it does.</para>
 327 </important>
 328 </para>
 329
 330 <para>This is a para with a footnote
 331   <footnote
 332     ><para>Stuff here <programlisting>This is a program listing
 333 that's two lines long.</programlisting></para>
 334     and stuff after the
 335 footnote</footnote></para>
 336 </refsect1>
 337
 338 </refentry>
 339 </reference>
 340 </book>