Skip to content

Commit de8b2fa

Browse files
zcorpansvgeesus
authored andcommitted
Update the Changes section
Also mark non-normative sections as such.
1 parent ae5da4a commit de8b2fa

File tree

1 file changed

+33
-7
lines changed

1 file changed

+33
-7
lines changed

geometry/Overview.bs

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,8 @@ a.selected-text-file-an-issue {
5757

5858
<h2 id=intro>Introduction</h2>
5959

60+
<p><em>This section is non-normative.</em>
61+
6062
<p>This specification describes several geometry interfaces for the representation of points,
6163
rectangles, quadrilaterals and transformation matrices with the dimension of 3x2 and 4x4.
6264

@@ -2049,6 +2051,8 @@ specification could potentially introduce security or privacy issues.
20492051

20502052
<h2 id="historical">Historical</h2>
20512053

2054+
<p><em>This section is non-normative.</em>
2055+
20522056
<p>The interfaces in this specification are intended to replace earlier similar interfaces found in
20532057
various specifications as well as proprietary interfaces found in some user agents. This section
20542058
attempts to enumerate these interfaces.
@@ -2081,13 +2085,25 @@ this specification will not support <code>MSCSSMatrix</code>.
20812085

20822086
<h2 class="no-num" id="changes">Changes since last publication</h2>
20832087

2088+
<p><em>This section is non-normative.</em>
2089+
20842090
<p>The following changes were made since the <a
20852091
href="https://www.w3.org/TR/2014/WD-geometry-1-20140918/">18 September 2014 Working Draft</a>.
20862092

20872093
<ul>
2094+
<li><p>Changed the interfaces to generally use specific static operations for construction instead
2095+
of using overloaded constructors, and made the interfaces more consistent. However, {{DOMMatrix}}
2096+
still uses an overloaded constructor for compatibility with {{WebKitCSSMatrix}}.
2097+
2098+
<li><p>Introduced the {{DOMMatrixInit}} dictionary.
2099+
2100+
<li><p>Removed the <code>DOMRectList</code> interface.
2101+
2102+
<li><p>Added JSON serializers for the interfaces.
2103+
20882104
<li>
20892105
<p>Changed {{DOMMatrixReadOnly}} and {{DOMMatrix}} to be compatible with
2090-
<code>WebKitCSSMatrix</code>:
2106+
{{WebKitCSSMatrix}}:
20912107

20922108
<ul>
20932109
<li><p>Changed {{DOMMatrixReadOnly/rotate()}} and {{DOMMatrix/rotateSelf()}} arguments from
@@ -2100,19 +2116,29 @@ href="https://www.w3.org/TR/2014/WD-geometry-1-20140918/">18 September 2014 Work
21002116
<li><p>Made all arguments optional for {{DOMMatrix}}/{{DOMMatrixReadOnly}} methods, except for
21012117
{{DOMMatrix/setMatrixValue()}}.
21022118

2103-
<li><p>Changed <code>fromString()</code> static method to overloaded constructor.
2104-
21052119
<li><p>Added no-argument constructor.
21062120

2107-
<li><p>Defined <code>window.WebKitCSSMatrix</code> to alias {{DOMMatrix}}.
2121+
<li><p>Defined {{WebKitCSSMatrix}} to be a legacy window alias for {{DOMMatrix}}.
21082122
</ul>
21092123

21102124
<li><p>Exposed {{DOMPointReadOnly}}, {{DOMPoint}}, {{DOMRectReadOnly}}, {{DOMRect}}, {{DOMQuad}},
2111-
{{DOMMatrixReadOnly}} and {{DOMMatrix}} to {{Window}} and {{Worker}}. Defined cloning of the
2112-
interfaces.
2125+
{{DOMMatrixReadOnly}} and {{DOMMatrix}} to {{Window}} and {{Worker}}. In workers, {{DOMMatrix}} and
2126+
{{DOMMatrixReadOnly}} do not support parsing or stringifying with CSS syntax.
2127+
2128+
<li><p>Defined structured serialization of the interfaces.
21132129

21142130
<li><p>The live <code>bounds</code> attribute on {{DOMQuad}} was replaced with a non-live
21152131
{{DOMQuad/getBounds()}} method. The "associated bounding rectangle" concept was also removed.
2132+
2133+
<li><p>Changed the string parser for {{DOMMatrix}} and {{DOMMatrixReadOnly}} to use CSS rules
2134+
instead of SVG rules.
2135+
2136+
<li><p>The stringifier for {{DOMMatrix}} and {{DOMMatrixReadOnly}} now throws if there are
2137+
non-finite values, and otherwise uses the [=ToString=] algorithm. [[ECMA-262]]
2138+
2139+
<li><p>Made comparisons treat ''0'' and ''-0'' as equal throughout.
2140+
2141+
<li><p>Added [[#priv-sec]] and [[#historical]] sections.
21162142
</ul>
21172143

21182144
<p>The following changes were made since the <a
@@ -2126,7 +2152,7 @@ Draft</a>.
21262152

21272153
<li><p>{{DOMMatrixReadOnly}} got a constructor taking a sequence of numbers as argument.
21282154

2129-
<li><p>DOMRectList turned to an ArrayClass. The interfaces must just be used for legacy interfaces.
2155+
<li><p>DOMRectList turned to an ArrayClass. The interfaces can just be used for legacy interfaces.
21302156

21312157
<li><p>Put DOMRectList on at-Risk awaiting browser feedback.
21322158

0 commit comments

Comments
 (0)