From 362aae352f787784284bd376df992749d9491f5f Mon Sep 17 00:00:00 2001
From: Warren Block <wblock@FreeBSD.org>
Date: Sun, 6 Jul 2014 04:03:27 +0000
Subject: [PATCH] Add an example showing the use of <example>.

---
 .../fdp-primer/docbook-markup/chapter.xml     | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
index d4c4a05de5..217ff33c7a 100644
--- a/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
+++ b/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
@@ -838,6 +838,33 @@
       </important>
     </sect2>
 
+    <sect2 xml:id="docbook-markup-example">
+      <title>Examples</title>
+
+      <para>Examples can be shown with <tag>example</tag>.</para>
+
+      <example>
+	<title><tag>example</tag></title>
+
+	<para>Usage:</para>
+
+	<programlisting><tag class="starttag">example</tag>
+  <tag class="starttag">para</tag>Empty files can be created easily:<tag class="endtag">para</tag>
+
+  <tag class="starttag">screen</tag>&amp;prompt.user&semi; <tag class="starttag">userinput</tag>touch file1 file2 file3<tag class="endtag">userinput</tag><tag class="endtag">screen</tag>
+<tag class="endtag">example</tag></programlisting>
+      </example>
+
+      <!-- Need to do this outside of the example -->
+      <para>Appearance:</para>
+
+      <example>
+	<para>Empty files can be created easily:</para>
+
+	<screen>&prompt.user; <userinput>touch file1 file2 file3</userinput></screen>
+      </example>
+    </sect2>
+
     <sect2 xml:id="docbook-markup-lists-and-procedures">
       <title>Lists and Procedures</title>