`arity/ref.xsl' documentation updated to reflect data adjacency guarantees

master
Mike Gerwitz 2014-12-04 03:33:50 -05:00
parent 4c27b8d15d
commit 0b5ed975a0
1 changed files with 13 additions and 3 deletions

View File

@ -31,15 +31,25 @@
The descriptor @var{desc} has the following format:
@example
<f:ref arity="N" [...]>
<f:ref arity="N" length="M" [...]>
<target />
</f:ref>
@end example
where the @var{target} node shares the same QName as the function to
be applied, and @var{@arity} is its arity. The @var{f:ref} node may
be decorated with additional attributes depending on its context or
be applied, and @var{@arity} is its arity. @var{@length} caches the
number of items (in a sequence) that make up the reference; it can
be retrieved with @code{f:length}. The @var{f:ref} node may be
decorated with additional attributes depending on its context or
constructor.
Each of these functions respects data adjacent to the given
reference (which is at the head of the sequence). For example,
@code{f:set-args} will set the arguments of the dynamic function
reference represented by the head of the provided sequence, but will
leave all data following the reference untouched; this allows
references to be processed in a streaming manner without cutting the
sequence up before operating on the reference.
-->
<stylesheet version="2.0"