1 <book xmlns="http://docbook.org/ns/docbook" version="5.0">
2 <info><title>Unit Test: refentry.007</title>
4 <releaseinfo role="CVS">$Id: refentry.007.xml 7282 2007-08-23 09:27:01Z xmldoc $</releaseinfo>
5 <author><personname><firstname>Norman</firstname><surname>Walsh</surname></personname><affiliation><address><email>ndw@nwalsh.com</email></address></affiliation></author>
7 <reference><info><title>Reference</title></info>
12 <author><personname><firstname>Norman</firstname><surname>Walsh</surname></personname><email>ndw@nwalsh.com</email><personblurb>
13 <para>Wrote the original version of this document.</para>
14 </personblurb></author>
15 <editor><personname><firstname>Michael(tm)</firstname><surname>Smith</surname></personname><contrib>Added a bunch of test cases.</contrib><email>smith@sideshowbarker.net</email></editor>
19 <holder>Norman Walsh</holder>
23 <holder>Michael(tm) Smith</holder>
26 <para>This file is a product of the DocBook Project.</para>
29 <para>Share and share alike.</para>
33 <refname>FirstName</refname>
34 <refname>SecondName</refname>
35 <refpurpose>Purpose for FirstName</refpurpose>
39 <refname>ThirdName</refname>
40 <refpurpose>Purpose for ThirdName</refpurpose>
46 <!-- * Yes, friend, Funcsynopsis is a verbatim -->
47 <funcsynopsisinfo>#include <varargs.h>
48 #include <mouteyh.h>
49 #include <qlmppzj.h></funcsynopsisinfo>
51 <funcdef><type>float</type> <function>rand</function></funcdef>
56 <funcdef>int <function>max</function></funcdef>
61 <funcdef>int <function>idiv</function></funcdef>
62 <paramdef><type>int</type> <parameter>n</parameter></paramdef>
63 <paramdef><type>int</type> <parameter>m</parameter></paramdef>
71 <funcdef>void <function>qsort</function></funcdef>
72 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
73 <paramdef>int <parameter>left</parameter></paramdef>
74 <paramdef>int <parameter>right</parameter></paramdef>
75 <paramdef>int (*<parameter>comp</parameter>)
76 <funcparams>void *, void *</funcparams></paramdef>
82 <funcdef>int <function>foo_frob_something</function></funcdef>
83 <paramdef>foo_sometype1 <parameter>foo_frob_parm1</parameter></paramdef>
84 <paramdef>foo_sometype1 <parameter>foo_frob_parm2</parameter></paramdef>
85 <paramdef>foo_sometype1 <parameter>foo_frob_parm3</parameter></paramdef>
86 <paramdef><type>int</type> (* <parameter>parm4</parameter> )
87 <funcparams>int a, int b, int c</funcparams>
89 <paramdef>foo_sometype1 <parameter>foo_frob_parm5</parameter></paramdef>
93 <funcdef>int <function>foo_frob_something</function></funcdef>
94 <paramdef>foo_sometype1 <parameter>foo_frob_parm1</parameter></paramdef>
95 <paramdef>foo_sometype1 <parameter>foo_frob_parm2</parameter></paramdef>
96 <paramdef>foo_sometype1 <parameter>foo_frob_parm3</parameter></paramdef>
97 <paramdef><type>int</type> (* <parameter>parm4</parameter> )
98 <funcparams>int a, int b, int c</funcparams>
100 <paramdef>foo_sometype1 <parameter>foo_frob_parm5</parameter></paramdef>
105 <refsection><info><title>Description</title></info>
107 <para>This is a minimal RefEntry.</para>
109 <para>The following is a Variablelist with a title.
110 <variablelist><info><title>My variablelist</title></info>
113 <term>varlistentry term 1</term>
114 <listitem><para>some listitem text</para></listitem>
117 <term>varlistentry term 2</term>
118 <listitem><para>some more listitem text</para></listitem>
122 <refsection><info><title>Subsection</title></info>
124 <para>This is a minimal RefEntry.</para>
126 <para>The following is a Variablelist with a title and a nested variablelist
130 <glossterm>glossentry term 1</glossterm>
131 <glossdef><para>some glossdef text</para></glossdef>
134 <glossterm>glossentry term 2</glossterm>
138 <term>nested variablelist term 1</term>
139 <listitem><para>some variablelist text</para></listitem>
142 <term>nested variablelist term 2</term>
143 <listitem><para>some more variablelist text</para></listitem>
151 <refsection><info><title>Sub-subsection</title></info>
153 <para>This is a minimal RefEntry.</para>
158 <refsection><info><title>More Description</title></info>
160 <para>This is a not-so minimal RefEntry.</para>
162 This is a screen [break here]
163 that starts with a line of space. [break here]
164 And it ends with a line of space.
167 <para>normal paragraph here</para>
169 <screen>This is a screen [break here]
170 that does not start with a line of space. [break here]
171 And does not end with a line of space.</screen>
173 <para>This is a normal paragraph that contains a screen.
174 <screen>This is a screen within a normal paragraph [break here]
175 that does not start with a line of space. [break here]
176 And does not end with a line of space but is followed
177 by a line of space.</screen>
180 <para>This is another normal paragraph that contains a screen.
181 <screen>This is a screen within a normal paragraph [break here]
182 that does not start with a line of space. [break here]
183 And does not end with a line of space and is not followed
184 by a line of space.</screen></para>
186 <para>This is another normal paragraph that contains a screen.
188 This is a screen within a normal paragraph [break here]
189 that starts with a line of space. [break here]
190 And ends with a line of space but is not followed by a line of space.
193 <para>This is another normal paragraph that contains a screen.
195 This is a screen within a normal paragraph [break here]
196 that starts with a line of space. [break here]
197 And ends with a line of space and is followed by a line of space.
201 <para>This is another normal paragraph that contains a screen.
204 This is a screen within a normal paragraph [break here]
205 that starts with a 2 lines of space. [break here]
206 And ends with 3 lines of space and is followed by a line of space.
212 <para>This paragraph contains an itemizedlist with a title. The title
214 <orderedlist inheritnum="ignore" continuation="restarts"><info><title>Mrignkwolmcng</title></info>
217 <para>itemizedlist listitem 1</para>
220 <para>itemizedlist listitem 2</para>
224 This is some useless text that follows the “Mrignkwolmcng” orderedlist
225 in the same para.</para>
227 <para>The following is a Variablelist with a title and with a nested itemizedlist.
228 <variablelist><info><title>My variablelist</title></info>
231 <term>varlistentry term 1</term>
233 <itemizedlist><info><title>nested itemizedlist</title></info>
236 <para>itemizedlist listitem 1</para>
239 <para>itemizedlist listitem 2</para>
245 <term>varlistentry term 2</term>
246 <listitem><para>some more listitem text</para></listitem>
251 <para>The following is a Variablelist with a title and with a
252 nested Varlistentry that contains multiple Terms
253 <variablelist><info><title>My nested-multi-term-per-varlistentry variablelist</title></info>
256 <term>Varlistentry term 1</term>
260 <term> varlistentry term 1.1</term>
261 <term>varlistentry term 1.2 </term>
262 <term>varlistentry term 1.3</term>
263 <listitem><para>All 'bout terms 1.1, 1.2, and 1.3</para>
270 <term>varlistentry term 2</term>
271 <listitem><para>some more listitem text</para></listitem>
276 <refsection><info><title>Subsection</title></info>
278 <para>This is a minimal RefEntry.</para>
282 <refsection><info><title>Even More Description</title></info>
284 <para>This is an even less minimal RefEntry.</para>
286 <para>This is a paragraph. It contains the following segmentedlist,
287 titled “Gibbererish”, with several segtitle elements.
290 <segtitle>Floober</segtitle>
291 <segtitle>Buugler</segtitle>
292 <segtitle>Sstangooo</segtitle>
293 <segtitle>Borobinda</segtitle>
295 <seg>Bamalalaboonda Bamalalaboonda Bamalalaboonda Bamalalaboonda Bamalalaboonda Bamalalaboonda</seg>
296 <seg>Mondorotoluafu</seg>
297 <seg>Ganafutralinga</seg>
298 <seg>Patagularamakundra</seg>
301 <seg>Cadraracondar</seg>
302 <seg>Hentirotomaambu</seg>
303 <seg>BdomentriolaiaBdomentriolaiaBdomentriolaia</seg>
304 <seg>Candamalaturuanio</seg>
307 This is some text that follows the segementedlist within the same
308 paragraph. The next part of this same paragraph is an
309 <tag>important</tag> admonition.
311 <para>It is very important that you read this. That’s why it stands
312 out the way that it does.</para>
316 <para>This is a para with a footnote
317 <footnote><para>Stuff here <programlisting>This is a program listing
318 that's two lines long.</programlisting></para>
320 footnote</footnote></para>