stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/tests/refentry.007.xml

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