From: Bob Stayton <bobs@sagehill.net>
Date: Thu, 11 Apr 2013 23:40:44 +0000 (+0000)
Subject: New param to turn off Optional text for optional steps.
X-Git-Tag: release/1.79.1~6^2~218
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3d58c9073056a5bba11a8d842c0d1819328d345c;p=docbook-dsssl

New param to turn off Optional text for optional steps.
---

diff --git a/xsl/params/mark.optional.procedure.steps.xml b/xsl/params/mark.optional.procedure.steps.xml
new file mode 100644
index 000000000..c8487ec2a
--- /dev/null
+++ b/xsl/params/mark.optional.procedure.steps.xml
@@ -0,0 +1,34 @@
+<refentry xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xi="http://www.w3.org/2001/XInclude"
+          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
+          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+          version="5.0" xml:id="mark.optional.procedure.steps">
+<refmeta>
+<refentrytitle>mark.optional.procedure.steps</refentrytitle>
+<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>mark.optional.procedure.steps</refname>
+<refpurpose>Specifies whether to mark optional procedure steps</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+  <src:fragment xml:id="mark.optional.procedure.steps.frag">
+    <xsl:param name="mark.optional.procedure.steps">1</xsl:param>
+  </src:fragment>
+</refsynopsisdiv>
+
+<refsection><info><title>Description</title></info>
+
+<para>This parameter specifies whether a procedure step
+with attribute <tag>performance</tag> set to <literal>optional</literal>
+should be marked.  If set to 1 (the default value), then the
+text "(Optional)" appears at the start of the first paragraph.
+If set to zero, then no text is generated.</para>
+
+<para>The text can be customized in the gentext element with 
+key="optional-step".</para>
+
+</refsection>
+</refentry>