Editorial: link DOMStringMap algorithms

annevk · domenic · commit fafd2e185ce5 · 2016-03-22T14:10:56.000-04:00
Also remove a note about it only describing a mapping to JavaScript, since that is true for all of IDL. Fixes https://www.w3.org/Bugs/Public/show_bug.cgi?id=28118.
diff --git a/source b/source
@@ -7665,8 +7665,9 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E..
   <div w-nodev>
 
   <p>When a <code>DOMStringMap</code> object is instantiated, it is associated with three
-  algorithms, one for getting the list of name-value pairs, one for setting names to certain values,
-  and one for deleting names.</p>
+  algorithms, one for <dfn>getting the list of name-value pairs</dfn>, one for <dfn>setting names to
+  certain values</dfn> (given a <var>name</var> and <var>value</var>), and one for <dfn>deleting
+  names</dfn> (given a <var>name</var>).</p>
 
   <pre class="idl">[OverrideBuiltins]
 interface <dfn>DOMStringMap</dfn> {
@@ -7676,22 +7677,22 @@ interface <dfn>DOMStringMap</dfn> {
 };</pre>
 
   <p>The <span>supported property names</span> on a <code>DOMStringMap</code> object at any instant
-  are the names of each pair returned from the algorithm for getting the list of name-value pairs at
-  that instant, in the order returned.</p>
+  are the names of each pair returned from the algorithm for <span>getting the list of name-value
+  pairs</span> at that instant, in the order returned.</p>
 
-  <p>To <dfn data-x="dom-DOMStringMap-namedItem">determine the value of a named property</dfn> <var>name</var> in a <code>DOMStringMap</code>, the user agent must return the value component
-  of the name-value pair whose name component is <var>name</var> in the list returned by
-  the algorithm for getting the list of name-value pairs.</p>
+  <p>To <dfn data-x="dom-DOMStringMap-namedItem">determine the value of a named property</dfn>
+  <var>name</var> in a <code>DOMStringMap</code>, the user agent must return the value component of
+  the name-value pair whose name component is <var>name</var> in the list returned by the algorithm
+  for <span>getting the list of name-value pairs</span>.</p>
 
   <p>To <dfn data-x="dom-DOMStringMap-setItem">set</dfn> the value of a named property
-  <var>name</var> to value <var>value</var>, the algorithm for setting names to certain values must
-  be run, passing <var>name</var> as the name and <var>value</var> as the value.</p>
-
-  <p>To <dfn data-x="dom-DOMStringMap-removeItem">delete an existing named property</dfn> <var>name</var>, the algorithm for deleting names must be run, passing <var>name</var> as the name.</p>
+  <var>name</var> to value <var>value</var>, the algorithm for <span>setting names to certain
+  values</span> must be run, passing <var>name</var> as the name and <var>value</var> as the
+  value.</p>
 
-  <p class="note">The <code>DOMStringMap</code> interface definition here is only intended for
-  JavaScript environments. Other language bindings will need to define how <code>DOMStringMap</code>
-  is to be implemented for those languages.</p>
+  <p>To <dfn data-x="dom-DOMStringMap-removeItem">delete an existing named property</dfn>
+  <var>name</var>, the algorithm for <span>deleting names</span> must be run, passing
+  <var>name</var> as the name.</p>
 
   </div>
 
@@ -11240,7 +11241,7 @@ translate="no">HTML&lt;/span> markup.&lt;/p></pre>
 
   <dl>
 
-   <dt>The algorithm for getting the list of name-value pairs</dt>
+   <dt>The algorithm for <span>getting the list of name-value pairs</span></dt>
 
    <dd>
     <ol>
@@ -11265,7 +11266,7 @@ translate="no">HTML&lt;/span> markup.&lt;/p></pre>
     </ol>
    </dd>
 
-   <dt>The algorithm for setting names to certain values</dt>
+   <dt>The algorithm for <span>setting names to certain values</span></dt>
 
    <dd>
     <ol>
@@ -11290,7 +11291,7 @@ translate="no">HTML&lt;/span> markup.&lt;/p></pre>
     </ol>
    </dd>
 
-   <dt>The algorithm for deleting names</dt>
+   <dt>The algorithm for <span>deleting names</span></dt>
 
    <dd>
     <ol>
@@ -11314,7 +11315,8 @@ translate="no">HTML&lt;/span> markup.&lt;/p></pre>
     </ol>
 
     <p class="note">This algorithm will only get invoked by the Web IDL specification for names that
-    are given by the earlier algorithm for getting the list of name-value pairs. <ref spec=WEBIDL></p>
+    are given by the earlier algorithm for <span>getting the list of name-value pairs</span>. <ref
+    spec=WEBIDL></p>
 
    </dd>
 
