From 8e43778a75b356ab79d903d8431d0d133aab801b Mon Sep 17 00:00:00 2001
From: Warren Block <wblock@FreeBSD.org>
Date: Sat, 5 Jul 2014 03:52:27 +0000
Subject: [PATCH] Add example of <stepalternative> to <procedure>.

---
 .../fdp-primer/docbook-markup/chapter.xml     | 33 +++++++++++++++++++
 1 file changed, 33 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 30bbed6803..d4c4a05de5 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
@@ -978,6 +978,11 @@
 	<tag>substep</tag>s.  Each <tag>step</tag>
 	contains block elements and may include an optional title.</para>
 
+      <para>Sometimes, steps are not sequential, but present a choice:
+	do <emphasis>this</emphasis> or do <emphasis>that</emphasis>,
+	but not both.  For these alternative choices, use
+	<tag>stepalternatives</tag>.</para>
+
       <example>
 	<title><tag>procedure</tag></title>
 
@@ -995,6 +1000,20 @@
   <tag class="starttag">step</tag>
     <tag class="starttag">para</tag>And now do this.<tag class="endtag">para</tag>
   <tag class="endtag">step</tag>
+
+  <tag class="starttag">step</tag>
+    <tag class="starttag">para</tag>Finally, do one of these.<tag class="endtag">para</tag>
+
+    <tag class="starttag">stepalternatives</tag>
+      <tag class="starttag">step</tag>
+	<tag class="starttag">para</tag>Go left.<tag class="endtag">para</tag>
+      <tag class="endtag">step</tag>
+
+      <tag class="starttag">step</tag>
+	<tag class="starttag">para</tag>Go right.<tag class="endtag">para</tag>
+      <tag class="endtag">step</tag>
+    <tag class="endtag">stepalternatives</tag>
+  <tag class="endtag">step</tag>
 <tag class="endtag">procedure</tag></programlisting>
 
 	<para>Appearance:</para>
@@ -1011,6 +1030,20 @@
 	  <step>
 	    <para>And now do this.</para>
 	  </step>
+
+	  <step>
+	    <para>Finally, do one of these:</para>
+
+	    <stepalternatives>
+	      <step>
+		<para>Go left.</para>
+	      </step>
+
+	      <step>
+		<para>Go right.</para>
+	      </step>
+	    </stepalternatives>
+	  </step>
 	</procedure>
       </example>
     </sect2>