Converted produceGeneralizedRdf option to produce generalized RDF flag
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Sun, 21 Jul 2013 19:08:35 +0200
changeset 1804 330d94671fdb
parent 1803 4ddc5db5221b
child 1805 37c4f96cc2c8
Converted produceGeneralizedRdf option to produce generalized RDF flag

We have no API for the toRDF operation so creating an option doesn't make sense.

This addresses #222
spec/latest/json-ld-api/index.html
--- a/spec/latest/json-ld-api/index.html	Sun Jul 21 18:55:11 2013 +0200
+++ b/spec/latest/json-ld-api/index.html	Sun Jul 21 19:08:35 2013 +0200
@@ -191,8 +191,7 @@
     <li>Clarify that blank node identifier are supported as value of <code>@vocab</code></li>
     <li>When generating RDF, exclude <tref title="rdf triple">triples</tref> containing a
       <tref>blank node</tref> <tref title="rdf predicate">predicate</tref>, unless the
-      <code class="idlMemberName"><a href="#widl-JsonLdOptions-produceGeneralizedRdf">produceGeneralizedRdf</a></code>
-      option is set.</li>
+      <i>produce generalized RDF</i> flag is set.</li>
   </ul>
 </section>
 
@@ -3142,9 +3141,7 @@
         <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>RDF graphs do not allow <tref title="blank node">blank nodes</tref> to be used
         as an <tref>RDF predicate</tref>, while JSON-LD does.
-        Unless the
-        <code class="idlMemberName"><a href="#widl-JsonLdOptions-produceGeneralizedRdf">produceGeneralizedRdf</a></code>
-        option is set, this algorithm will exclude
+        Unless the <i>produce generalized RDF</i> flag is set, this algorithm will exclude
         triples including a <tref>blank node</tref> <tref>RDF predicate</tref>.</p>
     </div>
 
@@ -3175,11 +3172,10 @@
       <h3>Algorithm</h3>
 
       <p>The algorithm takes a JSON-LD document <i>element</i> and returns an
-        <tref>RDF dataset</tref>. Unless set, the
-        <code class="idlMemberName"><a href="#widl-JsonLdOptions-produceGeneralizedRdf">produceGeneralizedRdf</a></code>
-        option of a <tref>JSON-LD API Implementation</tref> causes an <tref>RDF triple</tref>
-        containing a <tref>blank node</tref> <tref title="rdf predicate">predicate</tref> to be
-        excluded from output.</p>
+        <tref>RDF dataset</tref>. Unless the <i>produce generalized RDF</i> flag
+        is set to <tref>true</tref>, <tref title="RDF triple">RDF triples</tref>
+        containing a <tref>blank node</tref> <tref title="rdf predicate">predicate</tref>
+        are excluded from output.</p>
 
       <p>This algorithm generates new <tref title="blank node identifier">blank node identifiers</tref>
         and relabels existing <tref title="blank node identifier">blank node identifiers</tref>.
@@ -3212,8 +3208,8 @@
                     <li>Otherwise, if <i>property</i> is a <tref>keyword</tref>
                       continue to the next <i>property</i>-<i>values</i> pair.</li>
                     <li>Otherwise, if <i>property</i> is a <tref>blank node identifier</tref> and
-                      <code class="idlMemberName"><a href="#widl-JsonLdOptions-produceGeneralizedRdf">produceGeneralizedRdf</a></code>
-                      is not <code>true</code>, continue to the next <i>property</i>-<i>values</i> pair.</li>
+                      the <i>produce generalized RDF</i> flag is not <tref>true</tref>,
+                      continue to the next <i>property</i>-<i>values</i> pair.</li>
                     <li>Otherwise, <i>property</i> is an <tref>IRI</tref> or
                       <tref>blank node identifier</tref>. For each <i>item</i>
                       in <i>values</i>:
@@ -4003,12 +3999,6 @@
         different optimizations. Developers MUST NOT define modes beginning
         with <code>json-ld</code> as they are reserved for future versions
         of this specification.</dd>
-      <dt>boolean produceGeneralizedRdf = false</dt>
-      <dd>If set to <code>true</code>, the JSON-LD processor emits <tref title="rdf triple">RDF Triples</tref>
-        having a <tref>blank node</tref> <tref title="rdf predicate">predicate</tref>.
-        If set to <code>false</code>, <tref title="rdf triple">RDF Triples</tref>
-        having a <tref>blank node</tref> <tref title="rdf predicate">predicate</tref>
-        are excluded from output.</dd>
     </dl>
   </section> <!-- end JsonLdOptions -->