re p:iteration-source

in section 4.2.2 Example it illustrates the usage where the
p:iteration-source @select applies to the default input to the
for-each .... I think it would be useful to add some explicit text for
this scenario i would also add a bit more descriptive text to in
section 5.2 p:iteration-source e.g.

words to the effect of;

'Where p:iteration-source has no nested elements the xpath expression
in the @select applies to the primary input binding'

In addition, I would propose adding to p:iteration-source an attribute
that would throw an error if the @select matches nothing e.g.

<p:iteration-source
  select? = XPathExpression
 @fail-if-empty='true/false'>
    (p:empty |
      (p:pipe |
       p:document |
       p:inline)+)?
</p:iteration-source>

where if @fail-if-empty is set to true (defaults to false) a dynamic
error is thrown if @select matches nothing.

cheers, Jim Fuller

Received on Tuesday, 15 April 2008 20:27:17 UTC