svg2: Fix some nullable things in the IDL, and make getTransformToEle...

details:   https://svgwg.org/hg/svg2/rev/4ab729113814
branches:  
changeset: 408:4ab729113814
user:      Cameron McCormack <cam@mcc.id.au>
date:      Mon Dec 31 13:03:14 2012 +1100
description:
Fix some nullable things in the IDL, and make getTransformToElement take an SVGLocatableElement rather than an SVGElement.

diffstat:

 master/index.html |   6 ++----
 master/types.html |  23 ++++++++++++-----------
 2 files changed, 14 insertions(+), 15 deletions(-)

diffs (138 lines):

diff --git a/master/index.html b/master/index.html
--- a/master/index.html
+++ b/master/index.html
@@ -165,20 +165,18 @@ However, for translations in other langu
 
 <edit:minitoc/>
 </div>
 
 <h2 id="Acknowledgments">Acknowledgments</h2>
 
 <p>The SVG Working Group would like to thank the following people for
 contributing to this specification by raising issues that resulted
-in errata that were folded in to this document:
-M. Koray Ä°nal,
-Sebastian Kuzminsky,
-Helder Magalhães.
+in changes:
+David Zbarsky.
 </p>
 
 <p>In addition, the SVG Working Group would like to acknowledge the
 contributions of the editors and authors of the previous versions
 of SVG – as much of the text in this document derives from these
 earlier specifications – including:</p>
 
 <ul class="old-editor-list">
diff --git a/master/types.html b/master/types.html
--- a/master/types.html
+++ b/master/types.html
@@ -4205,40 +4205,40 @@ Corresponds to value <span class="attr-v
   </table>
 </div>
 
 <p>Interface <a>SVGLocatableElement</a> is for all elements to which the
 <a>'transform'</a> property applies or which can have a bounding box in current user space.</p>
 
 <pre class="idl">interface <b>SVGLocatableElement</b> : <a>SVGElement</a> {
 
-  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> <a href="types.html#__svg__SVGLocatableElement__nearestViewportElement">nearestViewportElement</a>;
-  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> <a href="types.html#__svg__SVGLocatableElement__farthestViewportElement">farthestViewportElement</a>;
+  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>? <a href="types.html#__svg__SVGLocatableElement__nearestViewportElement">nearestViewportElement</a>;
+  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>? <a href="types.html#__svg__SVGLocatableElement__farthestViewportElement">farthestViewportElement</a>;
 
   <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> <a href="types.html#__svg__SVGLocatableElement__getBBox">getBBox</a>();
   <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> <a href="types.html#__svg__SVGLocatableElement__getStrokeBBox">getStrokeBBox</a>();
-  <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <a href="types.html#__svg__SVGLocatableElement__getCTM">getCTM</a>();
-  <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <a href="types.html#__svg__SVGLocatableElement__getScreenCTM">getScreenCTM</a>();
-  <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <a href="types.html#__svg__SVGLocatableElement__getTransformToElement">getTransformToElement</a>(<a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> element);
+  <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>? <a href="types.html#__svg__SVGLocatableElement__getCTM">getCTM</a>();
+  <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>? <a href="types.html#__svg__SVGLocatableElement__getScreenCTM">getScreenCTM</a>();
+  <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <a href="types.html#__svg__SVGLocatableElement__getTransformToElement">getTransformToElement</a>(<a class="idlinterface" href="types.html#InterfaceSVGLocatableElement">SVGLocatableElement</a> element);
 };</pre><dl class="interface">
 <dt class="attributes-header">Attributes:</dt>
 <dd>
 <dl class="attributes">
 
-<dt id="__svg__SVGLocatableElement__nearestViewportElement" class="attribute first-child"><b>nearestViewportElement</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>)</span></dt>
+<dt id="__svg__SVGLocatableElement__nearestViewportElement" class="attribute first-child"><b>nearestViewportElement</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>?)</span></dt>
 <dd class="attribute">
 <div>
 The element which established the current viewport. Often, the nearest
 ancestor <a>'svg'</a> element. Null if the current element is the
 <a>outermost svg element</a>.
 
 </div>
 </dd>
 
-<dt id="__svg__SVGLocatableElement__farthestViewportElement" class="attribute"><b>farthestViewportElement</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>)</span></dt>
+<dt id="__svg__SVGLocatableElement__farthestViewportElement" class="attribute"><b>farthestViewportElement</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>?)</span></dt>
 <dd class="attribute">
 <div>
 The farthest ancestor <a>'svg'</a> element. Null if the current element
 is the <a>outermost svg element</a>.
 
 </div>
 </dd>
 </dl>
@@ -4290,37 +4290,38 @@ even in case the element has not yet bee
 <dd>
 <div> An <a>SVGRect</a> object that defines the stroke bounding box.
 
 </div>
 </dd>
 </dl>
 </dd>
 
-<dt id="__svg__SVGLocatableElement__getCTM" class="operation"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <b>getCTM</b>()
+<dt id="__svg__SVGLocatableElement__getCTM" class="operation"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>? <b>getCTM</b>()
 </dt>
 <dd class="operation">
 <div>
 Returns the transformation matrix from current user units (i.e., after
 application of the <a>'transform'</a> property) to the viewport
-coordinate system for the <a>nearestViewportElement</a>. 
+coordinate system for the <a>nearestViewportElement</a>. Note that null 
+is returned if this element is not hooked into the document tree.
 
 
 </div>
 <dl class="operation">
 <dt class="returns-header">Returns</dt>
 <dd>
 <div> An <a>SVGMatrix</a> object that defines the CTM.
 
 </div>
 </dd>
 </dl>
 </dd>
 
-<dt id="__svg__SVGLocatableElement__getScreenCTM" class="operation"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <b>getScreenCTM</b>()
+<dt id="__svg__SVGLocatableElement__getScreenCTM" class="operation"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>? <b>getScreenCTM</b>()
 </dt>
 <dd class="operation">
 <div>
 Returns the transformation matrix from current user units (i.e., after
 application of the <a>'transform'</a> property) to the parent
 user agent's notice of a "pixel". For display devices, ideally this
 represents a physical screen pixel. For other devices or environments
 where physical pixel sizes are not known, then an algorithm similar to
@@ -4337,17 +4338,17 @@ but the name <code>getScreenCTM</code> i
 <div> An <a>SVGMatrix</a> object that defines the given
 transformation matrix.
 
 </div>
 </dd>
 </dl>
 </dd>
 
-<dt id="__svg__SVGLocatableElement__getTransformToElement" class="operation"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <b>getTransformToElement</b>(<a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> <var>element</var>)
+<dt id="__svg__SVGLocatableElement__getTransformToElement" class="operation"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <b>getTransformToElement</b>(<a class="idlinterface" href="types.html#InterfaceSVGLocatableElement">SVGLocatableElement</a> <var>element</var>)
 </dt>
 <dd class="operation">
 <div>
 Returns the transformation matrix from the user coordinate system on the
 current element (after application of the <a>'transform'</a> property)
 to the user coordinate system on parameter <var>element</var>
 (after application of its <a>'transform'</a> property). 
 

Received on Monday, 31 December 2012 02:05:11 UTC