Use english-like language (instead of "equals") wrt null/constants.
authorDave Longley <dlongley@digitalbazaar.com>
Mon, 25 Feb 2013 21:33:48 -0500
changeset 1325 0749c2fb3f82
parent 1324 b10cc3a93691
child 1326 d399af715526
Use english-like language (instead of "equals") wrt null/constants.
spec/latest/json-ld-api/index.html
--- a/spec/latest/json-ld-api/index.html	Mon Feb 25 21:24:00 2013 -0500
+++ b/spec/latest/json-ld-api/index.html	Mon Feb 25 21:33:48 2013 -0500
@@ -943,14 +943,14 @@
   </li>
   <li>
     If <tref>local context</tref> is not an <tref>array</tref>, then
-    set it equal to an <tref>array</tref> containing only
+    set it to an <tref>array</tref> containing only
     <tref>local context</tref>.
   </li>
   <li>
     For each item <em>context</em> in <tref>local context</tref>:
     <ol class="algorithm">
       <li>
-        If <em>context</em> equals <tref>null</tref>, then set <em>result</em>
+        If <em>context</em> is <tref>null</tref>, then set <em>result</em>
         to a newly-initialized <tref>active context</tref> and continue to the
         next <em>context</em>.
       </li>
@@ -973,7 +973,7 @@
             <code>@vocab</code> key.
           </li>
           <li>
-            If <em>value</em> equals <tref>null</tref>, then remove
+            If <em>value</em> is <tref>null</tref>, then remove
             any <tref>vocabulary mapping</tref> from <em>result</em>.
           </li>
           <li>
@@ -996,7 +996,7 @@
             <code>@language</code> key.
           </li>
           <li>
-            If <em>value</em> equals <tref>null</tref>, then remove
+            If <em>value</em> is <tref>null</tref>, then remove
             any <tref>default language</tref> from <em>result</em>.
           </li>
           <li>
@@ -1115,7 +1115,7 @@
     <em>term</em> in <tref>local context</tref>.
   </li>
   <li>
-    If <em>value</em> equals <tref>null</tref> or <em>value</em>
+    If <em>value</em> is <tref>null</tref> or <em>value</em>
     is a <tref>JSON object</tref> containing the key-value pair
     (<code>@id</code>-<tref>null</tref>), then set the
     <tref>term definition</tref> in <tref>active context</tref> to
@@ -1135,7 +1135,7 @@
       </li>
       <li>
         If <em>value</em> is a <tref>keyword</tref>, then <em>value</em>
-        MUST NOT be equal to <code>@context</code>. Otherwise an invalid
+        MUST NOT be <code>@context</code>. Otherwise an invalid
         keyword alias has been detected, which is an error. Add <em>term</em>
         to <tref>active context</tref> as a <tref>keyword</tref> alias for
         <em>value</em>. If there is more than one <tref>keyword</tref> alias
@@ -1202,7 +1202,7 @@
         Otherwise <em>id</em> MUST be a <tref>string</tref>, otherwise
         an invalid value has been detected, which is an error. Set the
         <tref>IRI mapping</tref> for <em>definition</em>
-        equal to the result of using the
+        to the result of using the
         <a href="#iri-expansion">IRI Expansion</a> algorithm, passing
         <tref>active context</tref>, <em>id</em> for <em>value</em>,
         <tref>true</tref> for <em>vocabRelative</em>,
@@ -1245,12 +1245,12 @@
     If <em>value</em> contains the key <code>@type</code>:
     <ol class="algorithm">
       <li>
-        Initialize <em>type</em> equal to the value associated with the
+        Initialize <em>type</em> to the value associated with the
         <code>@type</code> key, which MUST be a <tref>string</tref>.
         Otherwise, an invalid value has been detected, which is an error.
       </li>
       <li>
-        If <em>type</em> does not equal <code>@id</code> then set it to
+        If <em>type</em> is not <code>@id</code> then set it to
         the result of using the
         <a href="#iri-expansion">IRI Expansion</a> algorithm, passing
         <tref>active context</tref>, <em>type</em> for <em>value</em>,
@@ -1265,7 +1265,7 @@
     If <em>value</em> contains the key <code>@container</code>:
     <ol class="algorithm">
       <li>
-        Initialize <em>container</em> equal to the value associated with the
+        Initialize <em>container</em> to the value associated with the
         <code>@container</code> key, which MUST be either:
         <code>@list</code>, <code>@set</code>, <code>@index</code>,
         or <code>@language</code>. Otherwise, an invalid value has been
@@ -1282,7 +1282,7 @@
     does not contain the key <code>@type</code>:
     <ol class="algorithm">
       <li>
-        Initialize <em>language</em> equal to the value associated with the
+        Initialize <em>language</em> to the value associated with the
         <code>@language</code> key, which MUST be either <tref>null</tref>
         or a <tref>string</tref>. Otherwise, an invalid value has been
         detected, which is an error.
@@ -1378,8 +1378,8 @@
   <li>If <em>element</em> is <tref>null</tref>, return <tref>null</tref>.</li>
   <li>If <em>element</em> is a <tref>scalar</tref>,
     <ol class="algorithm">
-      <li>If <em>insideList</em> equals <tref>false</tref> and
-        either <tref>active property</tref> equals <tref>null</tref> or
+      <li>If <em>insideList</em> is <tref>false</tref> and
+        either <tref>active property</tref> is <tref>null</tref> or
         the result of expanding <tref>active property</tref> using the
         <a href="#iri-expansion">IRI Expansion</a> algorithm is
         <code>@graph</code>, then drop the top-level
@@ -1404,7 +1404,7 @@
             and <em>insideList</em>.
           </li>
           <li>
-            If <em>insideList</em> equals <tref>true</tref> then
+            If <em>insideList</em> is <tref>true</tref> then
             <em>expanded item</em> MUST NOT be an <tref>array</tref> or a
             <tref>list object</tref>, otherwise a list of lists has been
             detected, which is an error.
@@ -1424,7 +1424,7 @@
   <li>Otherwise <em>element</em> is a <tref>JSON object</tref>.</li>
   <li>
     If <em>element</em> contains the key <code>@context</code>, set
-    <tref>active context</tref> equal to the result of the
+    <tref>active context</tref> to the result of the
     <a href="#context-processing">Context Processing</a> algorithm,
     passing <tref>active context</tref> and the value of the
     <code>@context</code> key as <tref>local context</tref>.
@@ -1442,7 +1442,7 @@
     ordered lexicographically by <em>key</em>:
     <ol class="algorithm">
       <li>
-        If <em>key</em> equals <code>@context</code>, continue to
+        If <em>key</em> is <code>@context</code>, continue to
         the next <em>key</em>.
       </li>
       <li>
@@ -1586,17 +1586,17 @@
         </ol>
       </li>
       <li>
-        Otherwise, if <em>expanded property</em> equals <code>@list</code>
+        Otherwise, if <em>expanded property</em> is <code>@list</code>
         or <code>@set</code>, initialize <em>expanded value</em> to the
         result of using this algorithm recursively passing
         <tref>active context</tref>, <tref>null</tref> for
-        <tref>active property</tref> if <em>expanded property</em> equals
-        <code>@list</code> and <em>expanded active property</em> equals
+        <tref>active property</tref> if <em>expanded property</em> is
+        <code>@list</code> and <em>expanded active property</em> is
         <code>@graph</code> otherwise <tref>active property</tref>,
         <em>value</em> for <em>element</em>, and <tref>true</tref>
-        for <em>insideList</em> if <em>expanded property</em> equals
+        for <em>insideList</em> if <em>expanded property</em> is
         <code>@list</code> otherwise <tref>false</tref>.
-        If <em>expanded property</em> equals <code>@list</code>
+        If <em>expanded property</em> is <code>@list</code>
         then <em>expanded value</em> MUST NOT be a
         <tref>list object</tref>, otherwise a list of lists has been
         detected, which is an error.
@@ -1610,7 +1610,7 @@
         <em>insideList</em>.
       </li>
       <li>
-        If <em>expanded value</em> equals <tref>null</tref> and
+        If <em>expanded value</em> is <tref>null</tref> and
         <em>expanded property</em> is not <code>@value</code> then
         drop <em>key</em> by continuing to the next key.
       </li>
@@ -1712,9 +1712,9 @@
     <code>@language</code>, set <em>result</em> to <tref>null</tref>.
   </li>
   <li>
-    If <em>insideList</em> equals false and either
-    <tref>active property</tref> equals <tref>null</tref> or
-    <em>expanded active property</em> equals <code>@graph</code>, then
+    If <em>insideList</em> is <tref>false</tref> and either
+    <tref>active property</tref> is <tref>null</tref> or
+    <em>expanded active property</em> is <code>@graph</code>, then
     drop free-floating values as follows:
     <ol class="algorithm">
       <li>
@@ -1850,7 +1850,7 @@
       <em>defined</em> are initialized to <tref>null</tref>.</p>
 
     <ol class="algorithm">
-      <li>If <em>value</em> is a <tref>keyword</tref> or equals <tref>null</tref>,
+      <li>If <em>value</em> is a <tref>keyword</tref> or is <tref>null</tref>,
         return <em>value</em> as is.</li>
       <li>If <tref>local context</tref> is not <tref>null</tref>, it contains
         a key that equals <em>value</em>, and the value associated with the key
@@ -1882,7 +1882,7 @@
         <ol class="algorithm">
           <li>Split <em>value</em> into a <tref>prefix</tref> and <em>suffix</em>
             at the first occurrence of a colon (<code>:</code>).</li>
-          <li>If <tref>prefix</tref> does not equal underscore (<code>_</code>)
+          <li>If <tref>prefix</tref> is not underscore (<code>_</code>)
             and <em>suffix</em> does not begin with double-forward-slash
             (<code>//</code>), then it may be a <tref>compact IRI</tref>:
             <ol class="algorithm">
@@ -1908,7 +1908,7 @@
       <li>If <em>result</em> is <tref>null</tref>, set it to <em>value</em>.</li>
       <li>If <tref>active context</tref> indicates that <em>value</em> is a
         <tref>keyword</tref> alias then return the associated <tref>keyword</tref>.</li>
-      <li>If <tref>local context</tref> equals <tref>null</tref> and <em>result</em>
+      <li>If <tref>local context</tref> is <tref>null</tref> and <em>result</em>
         begins with an underscore and colon (<code>_:</code>) then <em>result</em> is a
         <tref>blank node identifier</tref>. Set <em>result</em> to the
         result of the
@@ -1916,11 +1916,11 @@
         algorithm, passing <tref>active context</tref> and <em>result</em>
         for <em>identifier</em>.</li>
       <li>Otherwise, if <em>result</em> does not contain a colon (<code>:</code>),
-        <em>vocabRelative</em> equals <tref>true</tref>, and
+        <em>vocabRelative</em> is <tref>true</tref>, and
         <tref>active context</tref> has a <tref>vocabulary mapping</tref>,
         then set <em>result</em> to the result of concatenating the
         <tref>vocabulary mapping</tref> with <em>result</em>.</li>
-      <li>Otherwise, if <em>documentRelative</em> equals <tref>true</tref>,
+      <li>Otherwise, if <em>documentRelative</em> is <tref>true</tref>,
         set <em>result</em> to the result of resolving <em>result</em> against
         the document base as per [[RFC3986]]. Only the basic algorithm in
         section 5.2 of [[RFC3986]] is used; neither Syntax-Based Normalization
@@ -2010,7 +2010,7 @@
 
 <ol class="algorithm">
   <li>
-    If <em>value</em> equals <tref>null</tref>, then return <tref>null</tref>.
+    If <em>value</em> is <tref>null</tref>, then return <tref>null</tref>.
   </li>
   <li>
     Initialize <em>expanded property</em> to the result of using the
@@ -2019,14 +2019,14 @@
     <em>value</em>, and <tref>true</tref> for <em>vocabRelative</em>.
   </li>
   <li>
-    If <em>expanded property</em> equals <code>@id</code> then return
+    If <em>expanded property</em> is <code>@id</code> then return
     the result of using the
     <a href="#iri-expansion">IRI Expansion</a> algorithm, passing
     <tref>active context</tref>, <em>value</em>, and <tref>true</tref>
     for <em>documentRelative</em>.
   </li>
   <li>
-    If <em>expanded property</em> equals <code>@type</code> then
+    If <em>expanded property</em> is <code>@type</code> then
     return the result of using the
     <a href="#iri-expansion">IRI Expansion</a> algorithm, passing
     <tref>active context</tref>, <em>value</em>, <tref>true</tref> for
@@ -2036,7 +2036,7 @@
   <li>
     If <tref>active property</tref> has a <tref>type mapping</tref> in
     <tref>active context</tref> that is <code>@id</code> or if
-    <em>expanded property</em> equals <code>@graph</code> and <em>value</em>
+    <em>expanded property</em> is <code>@graph</code> and <em>value</em>
     is a <tref>string</tref>, then return a new <tref>JSON object</tref>
     containing a single key-value pair where the key is <code>@id</code> and
     the value is the result of using the
@@ -2155,7 +2155,7 @@
         <li>For each <em>key</em>-<em>value</em> pair ordered lexicographically
           by <em>key</em>:
           <ol class="algorithm">
-            <li>If <em>key</em> does not equal <code>@id</code>, then replace
+            <li>If <em>key</em> is not <code>@id</code>, then replace
               <em>value</em> in <em>element</em> with the result of using
               this algorithm recursively, passing <tref>active context</tref>
               and <em>value</em> for <em>element</em>.</li>
@@ -2366,7 +2366,7 @@
         <em>shallow</em>.
       </li>
       <li>
-        If <em>expanded property</em> equals <code>@id</code> or
+        If <em>expanded property</em> is <code>@id</code> or
         <code>@type</code>:
           <ol class="algorithm">
             <li>
@@ -2377,7 +2377,7 @@
               algorithm, passing <tref>active context</tref>,
               <em>expanded value</em> for <em>iri</em>,
               and <tref>true</tref> for <em>vocabRelative</em> if
-              <em>expanded property</em> equals <code>@type</code>,
+              <em>expanded property</em> is <code>@type</code>,
               <tref>false</tref> otherwise.
             </li>
             <li>
@@ -2420,12 +2420,12 @@
           </ol>
         </li>
       <li>
-        If <em>expanded property</em> equals <code>@index</code>:
+        If <em>expanded property</em> is <code>@index</code>:
         <ol class="algorithm">
           <li>
             If <tref>active property</tref> has a
             <tref>container mapping</tref> in <tref>active context</tref>
-            that equals <code>@index</code>, then the compacted
+            that is <code>@index</code>, then the compacted
             result will be inside of an <code>@index</code>
             container, so simply drop the <code>@index</code>
             property by continuing to the next
@@ -2463,7 +2463,7 @@
             <em>item active property</em>, set this key's value in
             <em>result</em> to an empty <tref>array</tref>. Otherwise, if
             the key's value is not an <tref>array</tref>, then set it
-            equal to one containing only the value.
+            to one containing only the value.
           </li>
         </ol>
       </li>
@@ -2518,7 +2518,7 @@
                 <em>compacted item</em>.
               </li>
               <li>
-                If <em>container</em> does not equal <code>@list</code>:
+                If <em>container</em> is not <code>@list</code>:
                 <ol class="algorithm">
                   <li>
                     Convert <em>compacted item</em> to a
@@ -2554,7 +2554,7 @@
             </ol>
           </li>
           <li>
-            If <em>container</em> equals <code>@language</code> or
+            If <em>container</em> is <code>@language</code> or
             <code>@index</code>:
             <ol class="algorithm">
               <li>
@@ -2578,7 +2578,7 @@
                 If <em>map key</em> is not a key in <em>map object</em>,
                 then set this key's value in <em>map object</em>
                 to <em>compacted item</em>. Otherwise, if the value
-                is not an <tref>array</tref>, then set it equal to one
+                is not an <tref>array</tref>, then set it to one
                 containing only the value and then append
                 <em>compacted item</em> to it.
               </li>
@@ -2589,17 +2589,17 @@
             <ol class="algorithm">
               <li>
                 Initialize <em>useArray</em> to <tref>false</tref>. If
-                <em>container</em> equals <code>@set</code> or
+                <em>container</em> is <code>@set</code> or
                 <code>@list</code>, or <em>compacted item</em> is
                 an empty <tref>array</tref>, or
-                <em>expanded property</em> equals <code>@list</code> or
+                <em>expanded property</em> is <code>@list</code> or
                 <code>@graph</code>, then set <em>useArray</em>
                 to <tref>true</tref>.
               </li>
               <li>
                 If <em>useArray</em> is <tref>true</tref> and
                 <em>compacted item</em> is not an <tref>array</tref>,
-                then set it equal to a new <tref>array</tref>
+                then set it to a new <tref>array</tref>
                 containing only <em>compacted item</em>.
               </li>
               <li>
@@ -2611,7 +2611,7 @@
               <li>
                 Otherwise, if the value associated with the key that
                 equals <em>item active property</em> in <em>result</em>
-                is not an <tref>array</tref>, set it equal to a new
+                is not an <tref>array</tref>, set it to a new
                 <tref>array</tref> containing only the value. Then
                 append <em>compacted item</em> to the value if
                 <em>compacted item</em> is not an <tref>array</tref>,
@@ -2828,8 +2828,8 @@
                 types.
               </li>
               <li>
-                If <em>commonLanguage</em> equals <code>@none</code> and
-                <em>commonType</em> equals <code>@none</code>, then
+                If <em>commonLanguage</em> is <code>@none</code> and
+                <em>commonType</em> is <code>@none</code>, then
                 stop processing items in the list because it has been
                 detected that there is no common language or type amongst
                 the items.
@@ -2946,7 +2946,7 @@
   </li>
   <li>
     At this point, there is no <tref>compact IRI</tref> that <em>iri</em>
-    can be compacted to, so if <em>vocabRelative</em> equals
+    can be compacted to, so if <em>vocabRelative</em> is
     <tref>true</tref> and <tref>active context</tref> has a
     <tref>vocabulary mapping</tref>:
     <ol class="algorithm">
@@ -3370,7 +3370,7 @@
     <tref>language mapping</tref>.
   </li>
   <li>
-    If <em>typeOrLanguageValue</em> equals <code>@id</code> and
+    If <em>typeOrLanguageValue</em> is <code>@id</code> and
     <em>value</em> is a <tref>JSON object</tref> containing the key
     <code>@id</code>:
     <ol class="algorithm">
@@ -3448,7 +3448,7 @@
                 and <tref>false</tref> for <em>remove</em>.
               </li>
               <li>
-                If <em>match</em> equals <tref>true</tref>, then set
+                If <em>match</em> is <tref>true</tref>, then set
                 <em>selected term</em> to <em>propertyGeneratorTerm</em>.
               </li>
             </ol>
@@ -3551,11 +3551,11 @@
         <code>@index</code> is a key in <em>value</em> and
         <tref>active property</tref> does not have a
         <tref>container mapping</tref> in <tref>active context</tref> that
-        equals <code>@index</code>, set <em>preserveIndex</em> to
+        is <code>@index</code>, set <em>preserveIndex</em> to
         <tref>true</tref>.
       </li>
       <li>
-        If <em>preserveIndex</em> equals <tref>false</tref> and either
+        If <em>preserveIndex</em> is <tref>false</tref> and either
         <em>value</em> has a <code>@type</code> key with a value that
         matches <tref title="active property">active property's</tref>
         <tref>type mapping</tref> in <tref>active context</tref> or
@@ -3567,7 +3567,7 @@
       </li>
       <li>
         If <code>@value</code> is the only key in <em>value</em> or
-        <em>preserveIndex</em> equals <tref>false</tref> and either
+        <em>preserveIndex</em> is <tref>false</tref> and either
         there is no <tref>default language</tref> in
         <tref>active context</tref>, the value associated with the
         <code>@value</code> key in <em>value</em> is not a
@@ -3580,7 +3580,7 @@
         Initialize <em>result</em> to an empty <tref>JSON object</tref>.
       </li>
       <li>
-        If <em>preserveIndex</em> equals <tref>true</tref>, then add
+        If <em>preserveIndex</em> is <tref>true</tref>, then add
         a key-value pair to <em>result</em> where the key is the result
         using the <a href="#iri-compaction-algorithm">IRI compaction</a>
         algorithm, passing <tref>active context</tref> and
@@ -3635,12 +3635,12 @@
     the key <code>@id</code> in <em>value</em> for <em>iri</em>, and
     <tref>true</tref> for <em>vocabRelative</em> if
     <tref>active property</tref> has a <tref>type mapping</tref> in the
-    <tref>active context</tref> that is equal to <code>@vocab</code>.
+    <tref>active context</tref> that is <code>@vocab</code>.
   </li>
   <li>
     If <tref>active property</tref> has a <tref>type mapping</tref> in
-    the <tref>active context</tref> that is equal to <code>@id</code> or
-    <code>@vocab</code> or if <em>expanded property</em> equals
+    the <tref>active context</tref> that is <code>@id</code> or
+    <code>@vocab</code> or if <em>expanded property</em> is
     <code>@graph</code>, then return <em>term</em>.
   </li>
   <li>
@@ -3817,7 +3817,7 @@
     <li>Initialize an empty <tref>array</tref> flattened.</li>
     <li>For each <em>id</em>-<em>node</em> pair in <em>defaultGraph</em> ordered by <em>id</em>,
       add <em>node</em> to <em>flattened</em>.</li>
-    <li>If <em>context</em> equals <tref>null</tref>, return <em>flattened</em>.</li>
+    <li>If <em>context</em> is <tref>null</tref>, return <em>flattened</em>.</li>
     <li>Otherwise, return the result of compacting <em>flattened</em> according the
       <a href="#compaction-algorithm">Compaction algorithm</a> passing <em>context</em>
       ensuring that the compaction result uses the <code>@graph</code> keyword (or its alias)
@@ -3878,7 +3878,7 @@
           <code>@list</code> whose value is initialized to an empty <tref>array</tref>.</li>
         <li>Recursively call this algorithm passing the value of <em>element's</em>
           <code>@list</code> member as new <em>element</em> and <em>result</em> as <em>list</em>.</li>
-        <li>If <tref>active property</tref> equals <tref>null</tref> or <code>@graph</code>,
+        <li>If <tref>active property</tref> is <tref>null</tref> or <code>@graph</code>,
           <a href="#generate-blank-node-identifier">generate a blank node identifier</a> <em>id</em>
           and store <em>result</em> as value of the member <em>id</em> in <em>activeGraph</em>.</li>
         <li>Otherwise, add <em>result</em> to the the value of the <tref>active property</tref> member
@@ -3982,7 +3982,7 @@
   <li>For each <em>graph name</em> and <em>graph</em> in <em>nodeMap</em>:
     <ol class="algorithm">
       <li>Retrieve <em>triples</em> using the <a href="#nodemap-rdf">Node Map to RDF Subalgorithm</a>.</li>
-      <li>If <em>graph name</em> equals <code>@default</code>, add
+      <li>If <em>graph name</em> is <code>@default</code>, add
         <em>triples</em> to the <tref>default graph</tref> in <em>dataset</em>.</li>
       <li>Otherwise, create a <tref>named graph</tref> in <em>dataset</em>
         composed of <em>graph name</em> and <em>triples</em>.</li>