Mark use of method overloading as "at risk"
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Tue, 09 Apr 2013 19:38:22 +0200
changeset 1576 ba1e2f3c3ec6
parent 1575 4e87cae7111a
child 1577 6641b8f9d4c3
Mark use of method overloading as "at risk"

This addresses #238
spec/latest/json-ld-api/index.html
--- a/spec/latest/json-ld-api/index.html	Tue Apr 09 19:01:33 2013 +0200
+++ b/spec/latest/json-ld-api/index.html	Tue Apr 09 19:38:22 2013 +0200
@@ -3749,6 +3749,23 @@
       <code class="idlMemberName"><a href="#widl-JsonLdError-code">code</a></code>
       and processing is stopped.</li></p>
 
+    <div class="issue atrisk" data-number="5" title="Use of method overloading to make the options parameter optional">
+      <p class="atrisk-head">Note: This feature is
+        <a href="http://www.w3.org/2005/10/Process-20051014/tr#cfi">"at risk"</a> and may
+        be removed from this specification based on feedback. Please send feedback to
+        <a href="mailto:[email protected]">[email protected]</a>.
+        For the current status see
+        <a href="http://www.w3.org/2011/rdf-wg/wiki/JSON-LD_Features_at_Risk">features "at risk" in JSON-LD 1.0</a></p>
+      <p>The definition of the <a>JsonLdProcessor</a> interface uses method overloading
+        to make the "options" parameter optional. According to the current version of
+        the Web IDL specification [[WEBIDL]], this would not be supported as the
+        "options" parameter (a dictionary) and the callback parameter (a callback function)
+        are <a href="http://www.w3.org/TR/2012/CR-WebIDL-20120419/#dfn-distinguishable">not distinguishable</a>.
+        A <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=21640">bug report</a>
+        has been already been filed. If it turns out that this is not a bug, the
+        Working Group may change the interface by swapping the "options" and "callback" parameter.</p>
+    </div>
+
     <dl title="[Constructor] interface JsonLdProcessor" class="idl">
       <dt>void compact()</dt>
       <dd>