Removed Java and ECMAScript language binding appendices.
authorCameron McCormack <cam@mcc.id.au>
Sun, 05 Aug 2012 23:00:09 +1000
changeset 261 399d8b887070
parent 260 b201818a9ebb
child 262 a8955b79271c
Removed Java and ECMAScript language binding appendices.
master/animate.html
master/changes.html
master/conform.html
master/escript.html
master/java.html
master/publish.xml
master/svgdom.html
--- a/master/animate.html	Sun Aug 05 22:37:01 2012 +1000
+++ b/master/animate.html	Sun Aug 05 23:00:09 2012 +1000
@@ -2643,10 +2643,6 @@
 </dd>
 </dl>
 
-<p>For the corresponding Java binding, see
-<a href='http://www.w3.org/TR/2001/REC-smil-animation-20010904/#SMIL-Java-ElementTimeControl'>section 6.4</a>
-of SMIL Animation [<a href='refs.html#ref-SMILANIM'>SMILANIM</a>].</p>
-
 <h3 id="InterfaceTimeEvent">Interface TimeEvent</h3>
 
 <p>The <a>TimeEvent</a>
@@ -2821,10 +2817,6 @@
 </dd>
 </dl>
 
-<p>For the corresponding Java binding, see
-<a href='http://www.w3.org/TR/2001/REC-smil-animation-20010904/#SMIL-Java-TimeEvent'>section 6.4</a>
-of SMIL Animation [<a href='refs.html#ref-SMILANIM'>SMILANIM</a>].</p>
-
 
 <h3 id="InterfaceSVGAnimationElement">Interface SVGAnimationElement</h3>
 
--- a/master/changes.html	Sun Aug 05 22:37:01 2012 +1000
+++ b/master/changes.html	Sun Aug 05 23:00:09 2012 +1000
@@ -161,6 +161,20 @@
   exists in DOM4.</li>
 </ul>
 
+<h3 id="java">Java Language Binding</h3>
+
+<ul>
+  <li>Removed this appendix, as language bindings are now defined by
+  Web IDL.</li>
+</ul>
+
+<h3 id="escript">ECMAScript Language Binding</h3>
+
+<ul>
+  <li>Removed this appendix, as language bindings are now defined by
+  Web IDL.</li>
+</ul>
+
 <h3 id="refs">References</h3>
 
 <ul>
--- a/master/conform.html	Sun Aug 05 22:37:01 2012 +1000
+++ b/master/conform.html	Sun Aug 05 23:00:09 2012 +1000
@@ -352,9 +352,10 @@
   the ability to select and copy text from SVG content to the
   system clipboard.</li>
 
-  <li>The viewer must have complete support for an
-  ECMAScript binding of the <a href="svgdom.html">SVG Document Object Model</a>
-  [<a href="refs.html#ref-ECMA-262">ECMA-262</a>].</li>
+  <li>The viewer must be a
+  <a href="http://www.w3.org/TR/2012/CR-WebIDL-20120419/#dfn-conforming-ecmascript-implementation">conforming ECMAScript implementation</a>
+  of all the IDL fragments in this specification.
+  [<a href="refs.html#ref-WEBIDL">WEBIDL</a>]</li>
 </ul>
 
 <p>The <a href="http://www.w3.org/WAI/">Web Accessibility Initiative</a>
--- a/master/escript.html	Sun Aug 05 22:37:01 2012 +1000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,177 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional+edit//EN" "xhtml1-transitional+edit.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xmlns:edit="http://xmlns.grorg.org/SVGT12NG/">
-<head>
-  <title>ECMAScript Language Binding</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
-  <link rel="stylesheet"           title="Default"               type="text/css" media="screen" href="style/default_svg.css"/>
-  <link rel="alternate stylesheet" title="No issues/annotations" type="text/css" media="screen" href="style/default_no_issues.css"/>
-  <link rel="alternate stylesheet" title="CSS3 Unmodified"       type="text/css" media="screen" href="style/default.css"/>
-  <link rel="alternate stylesheet" title="SVG 1.1"               type="text/css" media="screen" href="style/svg-style.css"/>
-  <!-- W3C style sheet will be added here during processing. -->
-</head>
-<body>
-
-<h1>ECMAScript Language Binding</h1>
-
-<p class="normativity"><strong>This appendix is normative.</strong></p>
-
-<p>This appendix describes how to expose the SVG DOM to an ECMAScript language
-environment [<a href="refs.html#ref-ECMA-262">ECMA-262</a>].</p>
-
-<p>For descriptions of how interfaces and exceptions defined in other
-specifications are to be exposed to an ECMAScript language environment,
-consult the relevant specification:</p>
-
-<ul>
-  <li>For DOM Level 2 Core interfaces and exceptions, see
-  <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/ecma-script-binding.html">the DOM Level 2 Core ECMAScript Language Binding appendix</a>
-  ([<a href="refs.html#ref-DOM2">DOM2</a>], appendix E).</li>
-  <li>For DOM Level 2 Events interfaces, see
-  <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/ecma-script-binding.html">the DOM Level 2 Events ECMAScript Language Binding appendix</a>
-  ([<a href="refs.html#ref-DOM2EVENTS">DOM2EVENTS</a>], appendix C).</li>
-  <li>For DOM Level 2 Views interfaces, see
-  <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113/ecma-script-binding.html">the DOM Level 2 Views ECMAScript Language Binding appendix</a>
-  ([<a href="refs.html#ref-DOM2VIEWS">DOM2VIEWS</a>], appendix C).</li>
-  <li>For DOM Level 2 Style interfaces, see
-  <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/ecma-script-binding.html">the DOM Level 2 Style ECMAScript Language Binding appendix</a>
-  ([<a href="refs.html#ref-DOM2STYLE">DOM2STYLE</a>], appendix C).</li>
-</ul>
-
-<h2 id="Exceptions">Exceptions</h2>
-
-<p>The SVG DOM defines a single exception, <a>SVGException</a>, which is
-exposed to an ECMAScript language environment as follows.</p>
-
-<p>The ECMAScript global object has a property named <code>"SVGException"</code>
-whose value is an object with the following properties:</p>
-
-<ul>
-  <li>A read only property named <code>"SVG_WRONG_TYPE_ERR"</code>, whose value is the <span class='dom-attr-type'>Number</span> value 1.</li>
-  <li>A read only property named <code>"SVG_INVALID_VALUE_ERR"</code>, whose value is the <span class='dom-attr-type'>Number</span> value 2.</li>
-  <li>A read only property named <code>"SVG_MATRIX_NOT_INVERTABLE"</code>, whose value is the <span class='dom-attr-type'>Number</span> value 3.</li>
-</ul>
-
-<p>A host object that is an <a>SVGException</a> also has these three
-properties on itself, or somewhere in its prototype chain.  Every such host
-object also has a read only property named <code>"code"</code> whose value is a
-<span class='dom-attr-type'>Number</span>, corresponding to the
-<a>SVGException::code</a> exception member on <a>SVGException</a>.</p>
-
-<h2 id="Constants">Constants</h2>
-
-<p>For every interface defined in the SVG DOM that has one or more constants
-defined on it, there exists a property on the ECMAScript global object whose
-name is the name of the interface, and whose value is an object with a read
-only property for each of the constants.  The name of each of these read only
-properties is the name of the corresponding constant, and the value is
-a <span class='dom-attr-type'>Number</span> with the same value as that of
-the constant.</p>
-
-<p>A host object that implements an interface with constants defined on it
-has, on itself or somewhere in its prototype chain, these properties that
-correspond to the constants.</p>
-
-<h2 id="Types">Types</h2>
-
-<p>The following table gives the corresponding ECMAScript type for the IDL
-primitive types used in the SVG DOM.</p>
-
-<table class='vert' summary='Map of IDL types to ECMAScript types'>
-  <tr>
-    <th>IDL type</th>
-    <th>ECMAScript type</th>
-  </tr>
-  <tr>
-    <td>boolean</td>
-    <td><span class='dom-attr-type'>Boolean</span></td>
-  </tr>
-  <tr>
-    <td>float</td>
-    <td><span class='dom-attr-type'>Number</span></td>
-  </tr>
-  <tr>
-    <td>long</td>
-    <td><span class='dom-attr-type'>Number</span></td>
-  </tr>
-  <tr>
-    <td>unsigned short</td>
-    <td><span class='dom-attr-type'>Number</span></td>
-  </tr>
-  <tr>
-    <td>unsigned long</td>
-    <td><span class='dom-attr-type'>Number</span></td>
-  </tr>
-  <tr>
-    <td>DOMString</td>
-    <td><span class='dom-attr-type'>String</span></td>
-  </tr>
-</table>
-
-<p>When an ECMAScript <span class='dom-attr-type'>Number</span> is assigned to
-a property that corresponds to an attribute of an IDL integer type (long,
-unsigned short or unsigned long), or it is passed as an argument passed to an
-operation for which the argument type is an IDL integer type, then behavior is
-undefined if the <span class='dom-attr-type'>Number</span> value is not an
-integer within the range of that type.</p>
-
-<p>For an interface type, a host object that implements the given interface is
-used.</p>
-
-<h2 id="Objects">Objects</h2>
-
-<p>A host object that implements a given interface has properties on itself,
-or in its prototype chain, that correspond to the operations and attributes
-defined on that interface and all its superinterfaces.</p>
-
-<p>A property that corresponds to an attribute is read only if the attribute
-is read only, and has a name that is the same as the name of the attribute.
-When getting the property, a value of a type according to the <a href="#Types">Types</a>
-section above is returned.  When setting the property, if it is not read only,
-then behavior is defined only if a value of a type according to the
-<a href="#Types">Types</a> section is assigned to it.</p>
-
-<p>For example, if <var>a</var> is a host object that implements the
-<a>SVGLength</a> interface, then evaluating the statement:</p>
-
-<pre>a.valueAsString = "10";</pre>
-
-<p>has defined behavior, but evaluating the statement:</p>
-
-<pre>a.valueAsString = 10;</pre>
-
-<p>does not.</p>
-
-<p>A property that corresponds to an operation has a name that is the same
-as the name of the operation, and has a value that is a
-<span class='dom-attr-type'>Function</span> object.  The value returned
-from the <span class='dom-attr-type'>Function</span> is of a type according
-to the table in the <a href="#Types">Types</a> section above.  When calling
-the <span class='dom-attr-type'>Function</span>, behavior is only defined
-if the correct number of arguments is passed, and the type of each argument
-is the type according to the <a href="#Types">Types</a> table.  Also,
-behavior is only defined for invoking the <span class='dom-attr-type'>Function</span>
-with a <span class='dom-attr-type'>this</span> value that is equal to
-the object from which the <span class='dom-attr-type'>Function</span>
-was obtained.</p>
-
-<p>For example, if <var>L1</var> and <var>L2</var> are two distinct host objects that
-implement the <a>SVGPointList</a> interface and <var>p</var> is a host object
-that implements the <a>SVGPoint</a> interface, then evaluating the following
-statement has defined behavior:</p>
-
-<pre>L1.insertItemBefore(p, 0);</pre>
-
-<p>Evaluating any of the following statements, however, does not:</p>
-
-<pre>L1.insertItemBefore(p, '0');
-L1.insertItemBefore(p, -1);
-L1.insertItemBefore(p, 0.5);
-L1.insertItemBefore(p);
-L1.insertItemBefore(p, 0, 0);
-L1.insertItemBefore({ x: 10, y: 20 }, 0);
-L1.insertItemBefore.call([], p, 0);
-L1.insertItemBefore.call(L2, p, 0);</pre>
-
-</body>
-</html>
--- a/master/java.html	Sun Aug 05 22:37:01 2012 +1000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,77 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional+edit//EN" "xhtml1-transitional+edit.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xmlns:edit="http://xmlns.grorg.org/SVGT12NG/">
-<head>
-  <title>Java Language Binding</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
-  <link rel="stylesheet"           title="Default"               type="text/css" media="screen" href="style/default_svg.css"/>
-  <link rel="alternate stylesheet" title="No issues/annotations" type="text/css" media="screen" href="style/default_no_issues.css"/>
-  <link rel="alternate stylesheet" title="CSS3 Unmodified"       type="text/css" media="screen" href="style/default.css"/>
-  <link rel="alternate stylesheet" title="SVG 1.1"               type="text/css" media="screen" href="style/svg-style.css"/>
-  <!-- W3C style sheet will be added here during processing. -->
-</head>
-<body>
-
-<h1>Java Language Binding</h1>
-
-<p class="normativity"><em>This appendix is informative, not normative.</em></p>
-
-<h2 id="JavaBinding">The Java language binding</h2>
-
-<p>The Java language binding for the SVG Document Object Model definitions
-is available at:</p>
-
-<pre><edit:locallink href="java-binding.zip"/></pre>
-
-<p>Note that this language binding is not normative. The IDL Definitions are
-the normative parts of the SVG DOM.</p>
-
-<h2 id="UsingSVGWithJava">Using SVG with the Java language</h2>
-
-<p>When scripting SVG with a language such as ECMAScript, it is
-possible to embed script code directly in the SVG content using
-the <a>'script'</a> element and the event attributes (e.g., <a>'image/onload'</a>
-or <a>'onclick'</a>). For programming languages with a binary delivery
-format, such as the Java language, it is not possible to embed
-the code into the <a>'script'</a> element or within the event
-attributes. Therefore there is a need to specify how such
-languages can bind to and handle events in the SVG document.
-The following technique describes how this should be done when
-using the Java language and what is expected of the User Agent
-that supports dynamic SVG content through the Java language.</p>
-
-<ul>
-  <li>The <a>'script'</a> element should reference a jar file containing
-  the compiled code to handle the events fired by the document. For
-  example:
-<pre><![CDATA[
-<script type="application/java-archive" xlink:href="myJavaHandlers.jar"/>
-]]></pre>
-  </li>
-
-  <li>The manifest in the referenced jar file contains an entry,
-  SVG-Handler-Class, defining the class responsible for initializing
-  the event listeners on the SVG document. The entry should be a fully
-  qualified class name. For example:
-<pre>
-Manifest-Version: 1.1
-SVG-Handler-Class: org.example.svg.SVGHandler
-</pre>
-  </li>
-  <li>The class referenced by SVG-Handler-Class implements the
-  EventListenerInitializer interface defined as:
-<pre>
-public interface EventListenerInitializer {
-  void initializeEventListeners(SVGDocument doc);
-}
-</pre>
-  </li>
-
-  <li>The method initializeEventListeners() will be called by
-  the User Agent before the onload event is triggered.</li>
-</ul>
-
-<p>The event binding of other binary programming languages is not specified.</p>
-
-</body>
-</html>
--- a/master/publish.xml	Sun Aug 05 22:37:01 2012 +1000
+++ b/master/publish.xml	Sun Aug 05 23:00:09 2012 +1000
@@ -61,8 +61,6 @@
   <chapter name='extend'/>
   <appendix name='svgdom'/>
   <appendix name='idl'/>
-  <appendix name='java'/>
-  <appendix name='escript'/>
   <appendix name='implnote'/>
   <appendix name='conform'/>
   <appendix name='access'/>
--- a/master/svgdom.html	Sun Aug 05 22:37:01 2012 +1000
+++ b/master/svgdom.html	Sun Aug 05 23:00:09 2012 +1000
@@ -170,8 +170,7 @@
 a property that returns document meta information such as the
 date the file was created might be named "fileDateCreated". In
 the ECMAScript binding, properties are exposed as properties of
-a given object. In Java, properties are exposed with get and
-set methods.</p>
+a given object.</p>
 
 <p>For attributes with the CDATA data type, the case of the
 return value is that given in the source document.</p>
@@ -409,21 +408,6 @@
 will receive the event with regards to the other EventListeners
 on the <a>EventTarget</a>.</p>
 
-<p>In Java, one way that event listeners can be established is
-to define a class which implements the <a>EventListener</a> interface,
-such as:</p>
-
-<pre>
-class MyAction1 implements EventListener {
-  public void handleEvent(Event evt) {
-    // process the event
-  }
-}
-// ... later ...
-MyAction1 mc1 = new MyAction1();
-myElement.addEventListener("DOMActivate", mc1, false);
-</pre>
-
 <p>In ECMAScript, one way to establish an event listener is to
 define a function and pass that function to the <code>addEventListener</code> method:</p>