<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>27985</bug_id>
          
          <creation_ts>2015-02-09 09:25:13 +0000</creation_ts>
          <short_desc>[FO31] Spec refinements for random-number-generator</short_desc>
          <delta_ts>2016-12-16 19:55:26 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>XPath / XQuery / XSLT</product>
          <component>Functions and Operators 3.1</component>
          <version>Candidate Recommendation</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Michael Kay">mike</reporter>
          <assigned_to name="Michael Kay">mike</assigned_to>
          
          
          <qa_contact name="Mailing list for public feedback on specs from XSL and XML Query WGs">public-qt-comments</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>117761</commentid>
    <comment_count>0</comment_count>
    <who name="Michael Kay">mike</who>
    <bug_when>2015-02-09 09:25:13 +0000</bug_when>
    <thetext>I propose some minor tightening-up of the spec for fn:random-number-generator:

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

(b) The two returned functions (the &apos;permute&apos; function and the &apos;next&apos; 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: () =&gt; map(xs:string, item())
  implementation: as described in prose
  non-local variable bindings: none

permute:
  name: absent
  parameter names: (&quot;arg&quot;)
  signature: (item()*) =&gt; item()*
  implementation: as described in prose
  non-local variable bindings: none


(I&apos;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).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>117821</commentid>
    <comment_count>1</comment_count>
    <who name="Michael Kay">mike</who>
    <bug_when>2015-02-10 17:38:38 +0000</bug_when>
    <thetext>These editorial changes have been applied.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>