Editorial: Define an entry point for the fromMatrix() algorithm

Author: zcorpan

geometry/Overview.bs

@@ -130,7 +130,7 @@ the <dfn method dfn-for=DOMPoint id=dom-dompoint-frompoint><code>fromPoint(<var>
 
 <ol>
   <li>Create a new <a interface>DOMPoint</a> <var>point</var> initialized to <a attribute for=DOMPoint>x</a>, <a attribute for=DOMPoint>y</a>, <a attribute for=DOMPoint>z</a> and <a attribute for=DOMPoint>w</a> of the current point.</li>
-  <li>Let <var>matrix object</var> be the result of calling {{DOMMatrix/fromMatrix()}} with <var>matrix</var> as the argument.
+  <li>Let <var>matrix object</var> be the result of invoking <a>create a <code>DOMMatrix</code> from the dictionary</a> <var>matrix</var>.
   <li><i>Post-multiply</i> <var>point</var> with <var>matrix object</var>.</li>
   <li>Return <var>point</var>.</li>
 </ol>
@@ -707,8 +707,19 @@ when invoked with a sequence argument, must run the following steps:
   <dd>Throw a <code>TypeError</code> exception.</dd>
 </dl>
 
-The <dfn method lt=fromMatrix() dfn-for=DOMMatrixReadOnly id=dom-dommatrixreadonly-frommatrix><code>fromMatrix(<var>other</var>)</code></dfn> static method on {{DOMMatrixReadOnly}} and
-the <dfn method lt=fromMatrix() dfn-for=DOMMatrix id=dom-dommatrix-frommatrix><code>fromMatrix(<var>other</var>)</code></dfn> static method on {{DOMMatrix}} must follow these steps:
+The <dfn method lt=fromMatrix() dfn-for=DOMMatrixReadOnly
+id=dom-dommatrixreadonly-frommatrix><code>fromMatrix(<var>other</var>)</code></dfn> static method on
+{{DOMMatrixReadOnly}} must <a>create a <code>DOMMatrixReadOnly</code> from the dictionary</a>
+<var>other</var>.
+
+The <dfn method lt=fromMatrix() dfn-for=DOMMatrix
+id=dom-dommatrix-frommatrix><code>fromMatrix(<var>other</var>)</code></dfn> static method on
+{{DOMMatrix}} must <a>create a <code>DOMMatrix</code> from the dictionary</a> <var>other</var>.
+
+To <dfn lt="create a DOMMatrixReadOnly from the dictionary">create a <code>DOMMatrixReadOnly</code>
+from a dictionary</dfn> <var>other</var> or to <dfn lt="create a DOMMatrix from the
+dictionary">create a <code>DOMMatrix</code> from a dictionary</dfn> <var>other</var>, follow these
+steps:
 
 <ol>
   <li><a>Validate and fixup</a> <var>other</var>.</li>
@@ -1016,18 +1027,18 @@ Note: Authors who use chained method calls are recommended to use mutable transf
   <dt><dfn>multiplySelf(<var>other</var>)</dfn></dt>
   <dd>
     <ol>
-      <li>Let <var>other object</var> be the result of invoking {{DOMMatrix/fromMatrix()}} with <var>other</var> as the argument.</li>
-      <li>The <em>other object</em> matrix gets post-multiplied to the current matrix.</li>
-      <li>If <a>is2D</a> of <em>other object</em> is <code>false</code>, set <a>is2D</a> of the current matrix to <code>false</code>.</li>
+      <li>Let <var>other object</var> be the result of invoking <a>create a <code>DOMMatrix</code> from the dictionary</a> <var>other</var>.</li>
+      <li>The <var>other object</var> matrix gets post-multiplied to the current matrix.</li>
+      <li>If <a>is2D</a> of <var>other object</var> is <code>false</code>, set <a>is2D</a> of the current matrix to <code>false</code>.</li>
       <li>Return the current matrix.</li>
     </ol>
   </dd>
   <dt><dfn>preMultiplySelf(<var>other</var>)</dfn></dt>
   <dd>
     <ol>
-      <li>Let <var>other object</var> be the result of invoking {{DOMMatrix/fromMatrix()}} with <var>other</var> as the argument.</li>
-      <li>The <em>other object</em> matrix gets pre-multiplied to the current matrix.</li>
-      <li>If <a>is2D</a> of <em>other object</em> is <code>false</code>, set <a>is2D</a> of the current matrix to <code>false</code>.</li>
+      <li>Let <var>other object</var> be the result of invoking <a>create a <code>DOMMatrix</code> from the dictionary</a> <var>other</var>.</li>
+      <li>The <var>other object</var> matrix gets pre-multiplied to the current matrix.</li>
+      <li>If <a>is2D</a> of <var>other object</var> is <code>false</code>, set <a>is2D</a> of the current matrix to <code>false</code>.</li>
       <li>Return the current matrix.</li>
     </ol>
   </dd>