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>