W3C home > Mailing lists > Public > public-html-commits@w3.org > July 2011

html5/spec Overview.html,1.5050,1.5051

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 22 Jul 2011 07:24:53 +0000
To: public-html-commits@w3.org
Message-Id: <E1QkA6Q-00037e-3N@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv11988

Modified Files:
	Overview.html 
Log Message:
tweak the way we talk about exceptions (whatwg r6320)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5050
retrieving revision 1.5051
diff -u -d -r1.5050 -r1.5051
--- Overview.html	22 Jul 2011 07:23:14 -0000	1.5050
+++ Overview.html	22 Jul 2011 07:24:50 -0000	1.5051
@@ -573,8 +573,7 @@
      <li><a href="#transferable-objects"><span class="secno">2.8.6 </span>Transferable objects</a></li>
      <li><a href="#safe-passing-of-structured-data"><span class="secno">2.8.7 </span>Safe passing of structured data</a></li>
      <li><a href="#dom-feature-strings"><span class="secno">2.8.8 </span>DOM feature strings</a></li>
-     <li><a href="#exceptions"><span class="secno">2.8.9 </span>Exceptions</a></li>
-     <li><a href="#garbage-collection"><span class="secno">2.8.10 </span>Garbage collection</a></ol></li>
+     <li><a href="#garbage-collection"><span class="secno">2.8.9 </span>Garbage collection</a></ol></li>
    <li><a href="#namespaces"><span class="secno">2.9 </span>Namespaces</a></ol></li>
  <li><a href="#dom"><span class="secno">3 </span>Semantics, structure, and APIs of HTML documents</a>
   <ol>
@@ -2911,7 +2910,47 @@
 
      <li><dfn id="dom-event-target" title="dom-Event-target"><code>target</code></dfn> attribute</li>
 
-    </ul><p>The following features are defined in the DOM Events
+    </ul><p>The following <code><a href="#domexception">DOMException</a></code> codes are defined in
+    the DOM Core specification: <a href="#refsDOMCORE">[DOMCORE]</a></p>
+
+    <ol class="brief"><li value="1"><dfn id="index_size_err"><code>INDEX_SIZE_ERR</code></dfn></li>
+     <li value="2"><dfn id="domstring_size_err"><code>DOMSTRING_SIZE_ERR</code></dfn></li>
+     <li value="3"><dfn id="hierarchy_request_err"><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
+     <li value="4"><dfn id="wrong_document_err"><code>WRONG_DOCUMENT_ERR</code></dfn></li>
+     <li value="5"><dfn id="invalid_character_err"><code>INVALID_CHARACTER_ERR</code></dfn></li>
+     <li value="6"><dfn id="no_data_allowed_err"><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
+     <li value="7"><dfn id="no_modification_allowed_err"><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
+     <li value="8"><dfn id="not_found_err"><code>NOT_FOUND_ERR</code></dfn></li>
+     <li value="9"><dfn id="not_supported_err"><code>NOT_SUPPORTED_ERR</code></dfn></li>
+     <li value="10"><dfn id="inuse_attribute_err"><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
+     <li value="11"><dfn id="invalid_state_err"><code>INVALID_STATE_ERR</code></dfn></li>
+     <li value="12"><dfn id="syntax_err"><code>SYNTAX_ERR</code></dfn></li>
+     <li value="13"><dfn id="invalid_modification_err"><code>INVALID_MODIFICATION_ERR</code></dfn></li>
+     <li value="14"><dfn id="namespace_err"><code>NAMESPACE_ERR</code></dfn></li>
+     <li value="15"><dfn id="invalid_access_err"><code>INVALID_ACCESS_ERR</code></dfn></li>
+     <li value="16"><dfn id="validation_err"><code>VALIDATION_ERR</code></dfn></li>
+     <li value="17"><dfn id="type_mismatch_err"><code>TYPE_MISMATCH_ERR</code></dfn></li>
+     <li value="18"><dfn id="security_err"><code>SECURITY_ERR</code></dfn></li>
+     <li value="19"><dfn id="network_err"><code>NETWORK_ERR</code></dfn></li>
+     <li value="20"><dfn id="abort_err"><code>ABORT_ERR</code></dfn></li>
+     <li value="21"><dfn id="url_mismatch_err"><code>URL_MISMATCH_ERR</code></dfn></li>
+     <li value="22"><dfn id="quota_exceeded_err"><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
+     <li value="23"><dfn id="timeout_err"><code>TIMEOUT_ERR</code></dfn></li>
+     <li value="24"><dfn id="invalid_node_type_err"><code>INVALID_NODE_TYPE_ERR</code></dfn></li>
+     <li value="25"><dfn id="data_clone_err"><code>DATA_CLONE_ERR</code></dfn></li>
+      </ol><p>When this specification requires that a user agent <i>throw</i>
+    or <i>raise</i> an exception named using a code listed above, it
+    means that the user agent is required to create a
+    <code><a href="#domexception">DOMException</a></code> exception object configured to represent
+    the condition with the given code, then handle that object as a
+    thrown exception as defined in the JavaScript specification. <a href="#refsECMA262">[ECMA262]</a></p>
+
+    <p class="example">For example, to <i>throw a
+    <code><a href="#timeout_err">TIMEOUT_ERR</a></code> exception</i>, a user agent would
+    construct a <code><a href="#domexception">DOMException</a></code> object whose code was set to
+    23 and actually throw that object as an exception.</p>
+
+    <p>The following features are defined in the DOM Events
     specification: <a href="#refsDOMEVENTS">[DOMEVENTS]</a></p>
 
     <ul class="brief"><li><dfn id="uievent"><code>UIEvent</code></dfn> interface</li>
@@ -7537,33 +7576,9 @@
   with <var title="">feature</var> set to either "<code title="">HTML</code>" or "<code title="">XHTML</code>" and <var title="">version</var> set to either "<code>1.0</code>" or
   "<code>2.0</code>".</p>
 
-  </div><h4 id="exceptions"><span class="secno">2.8.9 </span>Exceptions</h4><p>The following are <code><a href="#domexception">DOMException</a></code> codes. <a href="#refsDOMCORE">[DOMCORE]</a><ol class="brief"><li value="1"><dfn id="index_size_err"><code>INDEX_SIZE_ERR</code></dfn></li>
-   <li value="2"><dfn id="domstring_size_err"><code>DOMSTRING_SIZE_ERR</code></dfn></li>
-   <li value="3"><dfn id="hierarchy_request_err"><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
-   <li value="4"><dfn id="wrong_document_err"><code>WRONG_DOCUMENT_ERR</code></dfn></li>
-   <li value="5"><dfn id="invalid_character_err"><code>INVALID_CHARACTER_ERR</code></dfn></li>
-   <li value="6"><dfn id="no_data_allowed_err"><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
-   <li value="7"><dfn id="no_modification_allowed_err"><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
-   <li value="8"><dfn id="not_found_err"><code>NOT_FOUND_ERR</code></dfn></li>
-   <li value="9"><dfn id="not_supported_err"><code>NOT_SUPPORTED_ERR</code></dfn></li>
-   <li value="10"><dfn id="inuse_attribute_err"><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
-   <li value="11"><dfn id="invalid_state_err"><code>INVALID_STATE_ERR</code></dfn></li>
-   <li value="12"><dfn id="syntax_err"><code>SYNTAX_ERR</code></dfn></li>
-   <li value="13"><dfn id="invalid_modification_err"><code>INVALID_MODIFICATION_ERR</code></dfn></li>
-   <li value="14"><dfn id="namespace_err"><code>NAMESPACE_ERR</code></dfn></li>
-   <li value="15"><dfn id="invalid_access_err"><code>INVALID_ACCESS_ERR</code></dfn></li>
-   <li value="16"><dfn id="validation_err"><code>VALIDATION_ERR</code></dfn></li>
-   <li value="17"><dfn id="type_mismatch_err"><code>TYPE_MISMATCH_ERR</code></dfn></li>
-   <li value="18"><dfn id="security_err"><code>SECURITY_ERR</code></dfn></li>
-   <li value="19"><dfn id="network_err"><code>NETWORK_ERR</code></dfn></li>
-   <li value="20"><dfn id="abort_err"><code>ABORT_ERR</code></dfn></li>
-   <li value="21"><dfn id="url_mismatch_err"><code>URL_MISMATCH_ERR</code></dfn></li>
-   <li value="22"><dfn id="quota_exceeded_err"><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
-   <li value="23"><dfn id="timeout_err"><code>TIMEOUT_ERR</code></dfn></li>
-   <li value="25"><dfn id="data_clone_err"><code>DATA_CLONE_ERR</code></dfn></li>
-  </ol><div class="impl">
+  </div><div class="impl">
 
-  <h4 id="garbage-collection"><span class="secno">2.8.10 </span>Garbage collection</h4>
+  <h4 id="garbage-collection"><span class="secno">2.8.9 </span>Garbage collection</h4>
 
   <p>There is an <dfn id="implied-strong-reference">implied strong reference</dfn> from any IDL
   attribute that returns a pre-existing object to that object.</p>
Received on Friday, 22 July 2011 07:24:58 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 22 July 2011 07:24:58 GMT