Debian Codegraph @

test/docbook/source/blocks.xml

raw
1 <chapter xmlns="http://docbook.org/ns/docbook"
2 id="blocks">
3 <title>Some Block Elements</title>
4 <titleabbrev>Some Blocks</titleabbrev>
5
6 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
7 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
8 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
9 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
10 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
11 porttitor condimentum nulla.</para>
12
13 <section id="admon">
14 <title>Admonitions</title>
15
16 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
17 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
18 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
19 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
20 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
21 porttitor condimentum nulla.</para>
22
23 <caution>
24 <title>Beware the Title!</title>
25 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
26 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
27 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
28 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
29 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
30 porttitor condimentum nulla.</para>
31 </caution>
32
33 <important>
34 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
35 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
36 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
37 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
38 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
39 porttitor condimentum nulla.</para>
40 </important>
41
42 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
43 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
44 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
45 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
46 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
47 porttitor condimentum nulla.</para>
48
49 <note>
50 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
51 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
52 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
53 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
54 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
55 porttitor condimentum nulla.</para>
56 </note>
57
58 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
59 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
60 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
61 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
62 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
63 porttitor condimentum nulla.</para>
64
65 <note role="bug">
66 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
67 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
68 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
69 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
70 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
71 porttitor condimentum nulla.</para>
72 </note>
73
74 <tip>
75 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
76 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
77 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
78 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
79 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
80 porttitor condimentum nulla.</para>
81 </tip>
82
83 <warning>
84 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
85 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
86 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
87 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
88 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
89 porttitor condimentum nulla.</para>
90 </warning>
91
92 </section> <!-- admon -->
93
94 <section id="formal-block">
95 <title>Formal Blocks</title>
96
97 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
98 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
99 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
100 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
101 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
102 porttitor condimentum nulla.</para>
103
104 <example>
105 <title>An Example</title>
106 <programlisting><![CDATA[
107 $(_DOC_LC_DOCS) : $(_DOC_C_DOCS)
108 if ! test -d $(dir $@); then mkdir $(dir $@); fi
109 case "$(srcdir)" in /*) sd="$(srcdir)";; *) sd="../$(srcdir)";;esac; \
110 if [ -f "C/$(notdir $@)" ]; then d="../"; else d="$$sd/"; fi; \
111 (cd $(dir $@) && \
112 $(_xml2po) -e -p \
113 "$${d}$(dir $@)$(patsubst %/$(notdir $@),%,$@).po" \
114 "$${d}C/$(notdir $@)" > $(notdir $@).tmp && \
115 cp $(notdir $@).tmp $(notdir $@) && rm -f $(notdir $@).tmp)
116 ]]></programlisting>
117 </example>
118
119 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
120 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
121 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
122 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
123 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
124 porttitor condimentum nulla.</para>
125
126 <figure>
127 <title>A Figure</title>
128 <mediaobject>
129 <imageobject>
130 <imagedata fileref="http://www.gnome.org/projects/orca/images/orca2-sm.jpg"/>
131 </imageobject>
132 <caption><para>The mascot for the <ulink
133 url="http://www.gnome.org/projects/orca/index.html">Orca screen
134 reader</ulink></para></caption>
135 </mediaobject>
136 </figure>
137 <informalfigure>
138 <mediaobject>
139 <imageobject>
140 <imagedata fileref="http://www.gnome.org/projects/orca/images/orca2-sm.jpg"/>
141 </imageobject>
142 <caption><para>The mascot for the <ulink
143 url="http://www.gnome.org/projects/orca/index.html">Orca screen
144 reader</ulink></para></caption>
145 </mediaobject>
146 </informalfigure>
147
148 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
149 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
150 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
151 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
152 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
153 porttitor condimentum nulla.</para>
154
155 </section> <!-- formal-block -->
156
157 <section id="programlisting">
158 <title>Program Listings</title>
159
160 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
161 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
162 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
163 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
164 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
165 porttitor condimentum nulla.</para>
166
167 <programlisting><![CDATA[
168 function runline (line, ix, jx, pre, aft, char, name, id, fmt) {
169 ix = match(line, /[\*\$\@\%\!\#]\{[^\}]*\}/)
170 if (ix > 0) {
171 jx = ix + index(substr(line, ix), "}");
172 pre = substr(line, 1, ix - 1);
173 aft = substr(line, jx);
174 char = substr(line, ix, 1);
175 name = substr(line, ix + 2, jx - ix - 3);
176 id = name;
177 while (sub(/[\.-]/, "_", id));
178 if (char == "!")
179 fmt = "<filename><link linkend='S__%s'>%s</link></filename>";
180 else if (char == "*")
181 fmt = "<function><link linkend='T__%s'>%s</link></function>";
182 else if (char == "%")
183 fmt = "<function><link linkend='M__%s'>%s</link></function>";
184 else if (char == "@")
185 fmt = "<parameter><link linkend='P__%s'>%s</link></parameter>";
186 else if (char == "$")
187 fmt = "<parameter>"name"</parameter>";
188 else if (char == "#")
189 fmt = "<literal>"name"</literal>";
190 else
191 fmt = name;
192 return sprintf("%s%s%s",
193 runline(pre),
194 sprintf(fmt, id, name),
195 runline(aft) );
196 } else {
197 return line;
198 }
199 }
200 ]]></programlisting>
201
202 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
203 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
204 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
205 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
206 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
207 porttitor condimentum nulla.</para>
208
209 <programlisting linenumbering="numbered"><![CDATA[
210 function runline (line, ix, jx, pre, aft, char, name, id, fmt) {
211 ix = match(line, /[\*\$\@\%\!\#]\{[^\}]*\}/)
212 if (ix > 0) {
213 jx = ix + index(substr(line, ix), "}");
214 pre = substr(line, 1, ix - 1);
215 aft = substr(line, jx);
216 char = substr(line, ix, 1);
217 name = substr(line, ix + 2, jx - ix - 3);
218 id = name;
219 while (sub(/[\.-]/, "_", id));
220 if (char == "!")
221 fmt = "<filename><link linkend='S__%s'>%s</link></filename>";
222 else if (char == "*")
223 fmt = "<function><link linkend='T__%s'>%s</link></function>";
224 else if (char == "%")
225 fmt = "<function><link linkend='M__%s'>%s</link></function>";
226 else if (char == "@")
227 fmt = "<parameter><link linkend='P__%s'>%s</link></parameter>";
228 else if (char == "$")
229 fmt = "<parameter>"name"</parameter>";
230 else if (char == "#")
231 fmt = "<literal>"name"</literal>";
232 else
233 fmt = name;
234 return sprintf("%s%s%s",
235 runline(pre),
236 sprintf(fmt, id, name),
237 runline(aft) );
238 } else {
239 return line;
240 }
241 }
242 ]]></programlisting>
243
244 <programlisting linenumbering="numbered" continuation="continues">
245 BEGIN { print "&lt;section&gt;"; }
246 </programlisting>
247
248 <programlisting linenumbering="numbered" continuation="continues">
249 <![CDATA[/<\!--\!\!/ {
250 inthis = "title";
251 this = "header";
252 next;
253 }
254 ]]></programlisting>
255
256 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
257 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
258 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
259 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
260 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
261 porttitor condimentum nulla.</para>
262
263 <programlisting linenumbering="numbered" startinglinenumber="701">
264 # The starting line number is 701.
265 # So this is line number 72.
266 </programlisting>
267
268
269 </section> <!-- programlisting -->
270
271 <section id="screen">
272 <title>Screens</title>
273
274 <para>This <sgmltag>screen</sgmltag> element has <sgmltag>prompt</sgmltag>,
275 <sgmltag>userinput</sgmltag>, and <sgmltag>computeroutput</sgmltag> elements.</para>
276
277 <screen><prompt>[shaunm@verso testbook] </prompt><userinput>make</userinput>
278 <computeroutput><![CDATA[if [ ! -d html ]; then mkdir html; fi
279 rm -f html/*.*
280 xsltproc --timing --nonet --xinclude -o html/ \
281 --param db.chunk.chunk_top 1 \
282 --stringparam theme.icon.admon.path "../../../data/icons/" \
283 --stringparam theme.icon.nav.previous "../../../data/icons/nav-previous.png" \
284 --stringparam theme.icon.nav.next "../../../data/icons/nav-next.png" \
285 ../../xslt/docbook/html/db2html.xsl \
286 testbook.xml
287 Parsing stylesheet ../../xslt/docbook/html/db2html.xsl took 0 ms
288 Parsing document testbook.xml took 51 ms
289 XInclude processing testbook.xml took 0 ms
290 Running stylesheet and saving result took 144 ms
291 ]]></computeroutput></screen>
292
293 <screen linenumbering="numbered"><prompt>[shaunm@verso testbook] </prompt><userinput>make</userinput>
294 <computeroutput><![CDATA[if [ ! -d html ]; then mkdir html; fi
295 rm -f html/*.*
296 xsltproc --timing --nonet --xinclude -o html/ \
297 --param db.chunk.chunk_top 1 \
298 --stringparam theme.icon.admon.path "../../../data/icons/" \
299 --stringparam theme.icon.nav.previous "../../../data/icons/nav-previous.png" \
300 --stringparam theme.icon.nav.next "../../../data/icons/nav-next.png" \
301 ../../xslt/docbook/html/db2html.xsl \
302 testbook.xml
303 Parsing stylesheet ../../xslt/docbook/html/db2html.xsl took 0 ms
304 Parsing document testbook.xml took 51 ms
305 XInclude processing testbook.xml took 0 ms
306 Running stylesheet and saving result took 144 ms
307 ]]></computeroutput></screen>
308
309 </section> <!-- screen -->
310
311 <section id="cmdsynopsis">
312 <title>Commands</title>
313 <cmdsynopsis>
314 <command>cd</command>
315 <arg choice="req"><replaceable>directory</replaceable></arg>
316 </cmdsynopsis>
317 <cmdsynopsis>
318 <command>cal</command>
319 <arg>-j</arg>
320 <arg>-y</arg>
321 <arg>month <arg>year</arg></arg>
322 </cmdsynopsis>
323 <cmdsynopsis>
324 <command>chgrp</command>
325 <arg>-R <group>
326 <arg>-H</arg>
327 <arg>-L</arg>
328 <arg>-P</arg>
329 </group></arg>
330 <arg>-f</arg>
331 <arg choice='plain'><replaceable>group</replaceable></arg>
332 <arg rep='repeat' choice='plain'><replaceable>file</replaceable></arg>
333 </cmdsynopsis>
334 <para>Here we use an <sgmltag>sbr</sgmltag> element:</para>
335 <cmdsynopsis>
336 <command>ls</command>
337 <group><arg>--all</arg><arg>--almost-all</arg></group>
338 <sbr/>
339 <arg>--ignore-backups</arg>
340 <sbr/>
341 <arg>--directory</arg>
342 <sbr/>
343 <arg>--human-readable</arg>
344 <sbr/>
345 <arg>--ignore=<replaceable>PATTERN</replaceable></arg>
346 <sbr/>
347 <arg>-l</arg>
348 <sbr/>
349 <arg rep="repeat"><replaceable>FILE</replaceable></arg>
350 </cmdsynopsis>
351 <para>And here we put <sgmltag>sbr</sgmltag> elements inside
352 <sgmltag>arg</sgmltag> and <sgmltag>group</sgmltag> elements:</para>
353 <cmdsynopsis>
354 <command>ls</command>
355 <group><arg>--all</arg><sbr/><arg>--almost-all</arg></group>
356 <arg>--ignore=<sbr/><group><replaceable>PATTERN</replaceable><sbr/><replaceable>PATTERN</replaceable><sbr/><replaceable>PATTERN</replaceable></group></arg>
357 <sbr/>
358 <arg>--ignore=<group><replaceable>PATTERN</replaceable><sbr/><replaceable>PATTERN</replaceable><sbr/><replaceable>PATTERN</replaceable></group></arg>
359 <sbr/>
360 <group><arg choice="req">fe=<sbr/>fi</arg><arg>fo</arg><sbr/><arg>fum</arg></group>
361 <sbr/>
362 <arg>-l</arg>
363 <arg rep="repeat"><replaceable>FILE</replaceable></arg>
364 </cmdsynopsis>
365
366 <para>Also, <sgmltag>sbr</sgmltag> tags with fragments:</para>
367 <cmdsynopsis>
368 <command>foo</command>
369 <group><synopfragmentref linkend="synopfrag1"/><arg>foo</arg><sbr/><arg>bar</arg></group>
370 <arg><synopfragmentref linkend="synopfrag2"/>foo=<sbr/>bar</arg>
371 <synopfragment id="synopfrag1">
372 <group><arg>foo</arg><sbr/><arg>bar</arg></group>
373 <arg>foo=<sbr/>bar</arg>
374 </synopfragment>
375 <synopfragment id="synopfrag2">
376 <group><arg>foo</arg><sbr/><arg>bar</arg></group>
377 <arg>foo=<sbr/>bar</arg>
378 </synopfragment>
379 </cmdsynopsis>
380
381 <para>Here we put two <sgmltag>cmdsynopsis</sgmltag> elements inside
382 a single <sgmltag>synopsis</sgmltag> element:</para>
383 <synopsis><cmdsynopsis>
384 <command>grep</command>
385 <arg><replaceable>options</replaceable></arg>
386 <arg choice="plain"><replaceable>PATTERN</replaceable></arg>
387 <arg rep="repeat"><replaceable>FILE</replaceable></arg>
388 </cmdsynopsis><cmdsynopsis>
389 <command>grep</command>
390 <arg><replaceable>options</replaceable></arg>
391 <group>
392 <arg>-e <replaceable>PATTERN</replaceable></arg>
393 <arg>-f <replaceable>FILE</replaceable></arg>
394 </group>
395 <arg rep="repeat"><replaceable>FILE</replaceable></arg>
396 </cmdsynopsis></synopsis>
397 <para>Here we just put both commands in a single <sgmltag>cmdsynopsis</sgmltag>
398 element:</para>
399 <cmdsynopsis>
400 <command>grep</command>
401 <arg><replaceable>options</replaceable></arg>
402 <arg choice="plain"><replaceable>PATTERN</replaceable></arg>
403 <arg rep="repeat"><replaceable>FILE</replaceable></arg>
404 <command>grep</command>
405 <arg><replaceable>options</replaceable></arg>
406 <group>
407 <arg>-e <replaceable>PATTERN</replaceable></arg>
408 <arg>-f <replaceable>FILE</replaceable></arg>
409 </group>
410 <arg rep="repeat"><replaceable>FILE</replaceable></arg>
411 </cmdsynopsis>
412 </section>
413
414 <section id="misc-block">
415 <title>Miscellaneous</title>
416
417 <epigraph>
418 <attribution>Henry Spencer</attribution>
419 <para>Those who do not understand Unix are condemned to reinvent it,
420 poorly.</para>
421 </epigraph>
422
423 <para>The above was brought to you courtesy of the <sgmltag>epigraph</sgmltag>
424 element. Now here is an <sgmltag>address</sgmltag> element:</para>
425
426 <address>Free Software Foundation
427 51 Franklin Street, Fifth Floor
428 Boston, MA 02110-1301
429 USA</address>
430
431 <para>Here is a <sgmltag>blockquote</sgmltag> element:</para>
432
433 <blockquote>
434 <attribution>Richard Stallman, from the <ulink
435 url="http://www.gnu.org/gnu/manifesto.html">GNU Manifeto</ulink></attribution>
436 <para>I consider that the golden rule requires that if I like a program
437 I must share it with other people who like it. Software sellers want to
438 divide the users and conquer them, making each user agree not to share
439 with others. I refuse to break solidarity with other users in this way.
440 I cannot in good conscience sign a nondisclosure agreement or a software
441 license agreement. For years I worked within the Artificial Intelligence
442 Lab to resist such tendencies and other inhospitalities, but eventually
443 they had gone too far: I could not remain in an institution where such
444 things are done for me against my will.</para>
445 </blockquote>
446
447 <formalpara>
448 <title>Formal Paragraph</title>
449 <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed risus dui,
450 faucibus at, blandit eu, congue in, sem. Suspendisse nec mi. Sed vel augue.
451 Cras egestas. Vivamus nisi. Fusce neque. Aenean posuere, orci non lacinia
452 consectetuer, neque libero semper metus, ut ullamcorper eros lorem at tellus.
453 Ut ante tellus, iaculis at, tincidunt quis, ultrices at, ligula. Pellentesque
454 porttitor condimentum nulla.</para>
455 </formalpara>
456
457 <para>Next we have a <sgmltag>literallayout</sgmltag> element:</para>
458
459 <literallayout>This is a line.
460 This is another line.
461 This line is indented.</literallayout>
462
463 <para>And here is a <sgmltag>synopsis</sgmltag> element:</para>
464 <synopsis><![CDATA[#include <gtk/gtk.h>
465
466 GtkButton;
467 GtkWidget* gtk_button_new (void);
468 GtkWidget* gtk_button_new_with_label (const gchar *label);
469 GtkWidget* gtk_button_new_with_mnemonic (const gchar *label);
470 GtkWidget* gtk_button_new_from_stock (const gchar *stock_id);
471 ]]></synopsis>
472 <synopsis linenumbering="numbered"><![CDATA[#include <gtk/gtk.h>
473 void gtk_button_pressed (GtkButton *button);
474 void gtk_button_released (GtkButton *button);
475 void gtk_button_clicked (GtkButton *button);
476 void gtk_button_enter (GtkButton *button);
477 void gtk_button_leave (GtkButton *button);
478 ]]></synopsis>
479
480 <!-- FIXME:
481 glossary stuff
482 -->
483
484 </section> <!-- misc-block -->
485
486 </chapter>