svn commit: r45210 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup

[Warren Block]

Author: wblock
Date: Sat Jul  5 03:52:27 2014
New Revision: 45210
URL: http://svnweb.freebsd.org/changeset/doc/45210

Log:
  Add example of <stepalternative> to <procedure>.

Modified:
  head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml

Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	Fri Jul  4 21:15:20 2014	(r45209)
+++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	Sat Jul  5 03:52:27 2014	(r45210)
@@ -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>