1.1 --- a/docs/reference.html Sun Nov 16 01:19:33 2008 +0100
1.2 +++ b/docs/reference.html Mon Nov 17 01:50:18 2008 +0100
1.3 @@ -144,6 +144,34 @@
1.4
1.5 <p>See the <a href="internationalisation.html">"Internationalisation"</a> document for more information on this attribute.</p>
1.6
1.7 +<h3><a name="i18n"></a>template:select</h3>
1.8 +
1.9 +<p>This attribute is used to select sections of the XML document being presented
1.10 +which are potentially different from the current element implied by the
1.11 +structure communicated in the template.
1.12 +</p>
1.13 +
1.14 +<p>Example:</p>
1.15 +
1.16 +<pre>
1.17 +<select template:attribute-field="destination">
1.18 + <option template:select="../question" template:value="position()" value="{position()}"></option>
1.19 +</select>
1.20 +</pre>
1.21 +
1.22 +<p>In this example, the <code>option</code> element is replicated for each
1.23 +<code>question</code> element appearing below the parent element in the XML
1.24 +document being presented. Since a list of results is traversed as a result, the
1.25 +position of each <code>question</code> element can be obtained and used in the
1.26 +resulting output.
1.27 +</p>
1.28 +
1.29 +<p>Syntax:</p>
1.30 +
1.31 +<pre>XPath-expression</pre>
1.32 +
1.33 +<p>The specified expression is evaluated in the context of the current element.</p>
1.34 +
1.35 <h2>Initialisation Annotations</h2>
1.36
1.37 <p>The annotation attributes in this section control the initialisation of documents where this is done by the XSLForms toolkit.</p>