Editorial: Use separate entry points instead of ignore3D

Fixes #217.

Author: zcorpan

geometry/Overview.bs

@@ -871,13 +871,12 @@ interface from SVG. [[SVG11]]
 
 <h3 id=dommatrixinit-dictionary>DOMMatrix2DInit and DOMMatrixInit dictionaries</h3>
 
-<p>To <dfn dfn-for=matrix>validate and fixup</dfn> a {{DOMMatrix2DInit}} or {{DOMMatrixInit}}
-dictionary <var>dict</var>, given a boolean <var>ignore3D</var> (<code>false</code> if not
-provided), run the following steps:
+<p>To <dfn dfn-for=matrix>validate and fixup (2D)</dfn> a {{DOMMatrix2DInit}} or {{DOMMatrixInit}}
+dictionary <var>dict</var>, run the following steps:
 
 <ol>
   <li>
-   <p>If if at least one of the following conditions are true for <var>dict</var>, throw a
+   <p>If if at least one of the following conditions are true for <var>dict</var>, then throw a
    {{TypeError}} exception and abort these steps.
 
    <ul>
@@ -898,12 +897,6 @@ provided), run the following steps:
 
     <li><p>{{DOMMatrix2DInit/f}} and {{DOMMatrix2DInit/m42}} are both present and
     [=SameValueZero=]({{DOMMatrix2DInit/f}}, {{DOMMatrix2DInit/m42}}) is <code>false</code>.
-
-    <li><p><var>ignore3D</var> is <code>false</code> and {{DOMMatrixInit/is2D}} is <code>true</code>
-    and: at least one of {{DOMMatrixInit/m13}}, {{DOMMatrixInit/m14}}, {{DOMMatrixInit/m23}},
-    {{DOMMatrixInit/m24}}, {{DOMMatrixInit/m31}}, {{DOMMatrixInit/m32}}, {{DOMMatrixInit/m34}},
-    {{DOMMatrixInit/m43}} are present with a value other than ''0'' or ''-0'', or at least one of
-    {{DOMMatrixInit/m33}}, {{DOMMatrixInit/m44}} are present with a value other than ''1''.
    </ul>
 
   <li><p>If {{DOMMatrix2DInit/m11}} is not present then set it to the value of member
@@ -923,8 +916,22 @@ provided), run the following steps:
 
   <li><p>If {{DOMMatrix2DInit/m42}} is not present then set it to the value of member
   {{DOMMatrix2DInit/f}}, or value ''0'' if {{DOMMatrix2DInit/f}} is also not present.
+</ol>
+
+<p class=note>The [=SameValueZero=] comparison algorithm returns <code>true</code> for two ''NaN''
+values, and also for ''0'' and ''-0''. [[!ECMA-262]]
 
-  <li><p>If <var>ignore3D</var> is <code>true</code>, then return.
+<p>To <dfn dfn-for=matrix>validate and fixup</dfn> a {{DOMMatrixInit}} dictionary <var>dict</var>,
+run the following steps:
+
+<ol>
+  <li><p><a for=matrix>Validate and fixup (2D)</a> <var>dict</var>.</p>
+
+  <li><p>If {{DOMMatrixInit/is2D}} is <code>true</code> and: at least one of {{DOMMatrixInit/m13}},
+  {{DOMMatrixInit/m14}}, {{DOMMatrixInit/m23}}, {{DOMMatrixInit/m24}}, {{DOMMatrixInit/m31}},
+  {{DOMMatrixInit/m32}}, {{DOMMatrixInit/m34}}, {{DOMMatrixInit/m43}} are present with a value other
+  than ''0'' or ''-0'', or at least one of {{DOMMatrixInit/m33}}, {{DOMMatrixInit/m44}} are present
+  with a value other than ''1'', then throw a {{TypeError}} exception and abort these steps.
 
   <li><p>If {{DOMMatrixInit/is2D}} is not present and at least one of {{DOMMatrixInit/m13}},
   {{DOMMatrixInit/m14}}, {{DOMMatrixInit/m23}}, {{DOMMatrixInit/m24}}, {{DOMMatrixInit/m31}},
@@ -935,9 +942,6 @@ provided), run the following steps:
   <li><p>If {{DOMMatrixInit/is2D}} is still not present, set it to <code>true</code>.
 </ol>
 
-<p class=note>The [=SameValueZero=] comparison algorithm returns <code>true</code> for two ''NaN''
-values, and also for ''0'' and ''-0''. [[!ECMA-262]]
-
 
 <h3 id=dommatrix-parse algorithm>Parsing a string into an abstract matrix</h3>
 
@@ -1078,19 +1082,31 @@ id=dom-dommatrixreadonly-frommatrix><code>fromMatrix(<var>other</var>)</code></d
 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>.
 
+<p>To <dfn lt="create a DOMMatrixReadOnly from the 2D dictionary">create a
+<code>DOMMatrixReadOnly</code> from a 2D dictionary</dfn> <var>other</var> or to <dfn lt="create a
+DOMMatrix from the 2D dictionary">create a <code>DOMMatrix</code> from a 2D dictionary</dfn>
+<var>other</var>, follow these steps:
+
+<ol>
+ <li><a for=matrix>Validate and fixup (2D)</a> <var>other</var>.
+
+ <li><p>Return the result of invoking <a>create a 2d matrix</a> of type {{DOMMatrixReadOnly}} or
+ {{DOMMatrix}} as appropriate, with a sequence of numbers, the values being the 6 elements
+ {{DOMMatrix2DInit/m11}}, {{DOMMatrix2DInit/m12}}, {{DOMMatrix2DInit/m21}}, {{DOMMatrix2DInit/m22}},
+ {{DOMMatrix2DInit/m41}} and {{DOMMatrix2DInit/m42}} of <var>other</var> in the given order.
+</ol>
+
 <p>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>, given a boolean <var>ignore3D</var> (<code>false</code> if not provided), follow
-these steps:
+<var>other</var>, follow these steps:
 
 <ol>
- <li><a for=matrix>Validate and fixup</a> <var>other</var>, given <var>ignore3D</var>.
+ <li><a for=matrix>Validate and fixup</a> <var>other</var>.
 
  <li>
   <dl class=switch>
-   <dt>If <var>ignore3D</var> is <code>true</code> or if the {{DOMMatrixInit/is2D}} dictionary
-   member of <var>other</var> is <code>true</code>
+   <dt>If the {{DOMMatrixInit/is2D}} dictionary member of <var>other</var> is <code>true</code>
    <dd><p>Return the result of invoking <a>create a 2d matrix</a> of type {{DOMMatrixReadOnly}} or
    {{DOMMatrix}} as appropriate, with a sequence of numbers, the values being the 6 elements
    {{DOMMatrix2DInit/m11}}, {{DOMMatrix2DInit/m12}}, {{DOMMatrix2DInit/m21}}, {{DOMMatrix2DInit/m22}},