From df8be391bbd5edcae8a8f607ea9b03ae509a910b Mon Sep 17 00:00:00 2001
From: Michael Kay
It is the responsibility of each function implementation to invoke this conversion; it does not happen automatically as a consequence of the function-calling rules.
In cases where an option is list-valued, by convention the function should accept
- either a sequence or an array: but this rule applies only if the specification
- of the option explicitly accepts either. Accepting a sequence is convenient if the
- value is generated programmatically using an XPath expression; while accepting an array
- allows the options to be held in an external file in JSON format, to be read using
- a call on the fn:json-doc
function.
In cases where the value of an option is itself a map, the specification of the particular function must indicate whether or not these rules apply recursively to the contents of that map.