This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 27985 - [FO31] Spec refinements for random-number-generator
Summary: [FO31] Spec refinements for random-number-generator
Alias: None
Product: XPath / XQuery / XSLT
Classification: Unclassified
Component: Functions and Operators 3.1 (show other bugs)
Version: Candidate Recommendation
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: Michael Kay
QA Contact: Mailing list for public feedback on specs from XSL and XML Query WGs
Depends on:
Reported: 2015-02-09 09:25 UTC by Michael Kay
Modified: 2016-12-16 19:55 UTC (History)
0 users

See Also:


Description Michael Kay 2015-02-09 09:25:13 UTC
I propose some minor tightening-up of the spec for fn:random-number-generator:

(a) In the phrase "the keys of any such entries should start with an underscore character", give "should" RFC2119 markup.

(b) The two returned functions (the 'permute' function and the 'next' function) are somewhat informally described. We should be explicit about the function signature, name, and arity of each function as well as describing its effect:

  name: absent
  parameter names: ()
  signature: () => map(xs:string, item())
  implementation: as described in prose
  non-local variable bindings: none

  name: absent
  parameter names: ("arg")
  signature: (item()*) => item()*
  implementation: as described in prose
  non-local variable bindings: none

(I've given the argument of permute a name, because for some reason the data model says that function arguments have names, even though there is no way of writing a query that makes use of the fact).
Comment 1 Michael Kay 2015-02-10 17:38:38 UTC
These editorial changes have been applied.