W3C home > Mailing lists > Public > public-qt-comments@w3.org > February 2015

[Bug 27985] New: [FO31] Spec refinements for random-number-generator

From: <bugzilla@jessica.w3.org>
Date: Mon, 09 Feb 2015 09:25:13 +0000
To: public-qt-comments@w3.org
Message-ID: <bug-27985-523@http.www.w3.org/Bugs/Public/>
https://www.w3.org/Bugs/Public/show_bug.cgi?id=27985

            Bug ID: 27985
           Summary: [FO31] Spec refinements for random-number-generator
           Product: XPath / XQuery / XSLT
           Version: Candidate Recommendation
          Hardware: PC
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Functions and Operators 3.1
          Assignee: mike@saxonica.com
          Reporter: mike@saxonica.com
        QA Contact: public-qt-comments@w3.org

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:

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

permute:
  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).

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
Received on Monday, 9 February 2015 09:25:14 UTC

This archive was generated by hypermail 2.3.1 : Monday, 9 February 2015 09:25:15 UTC