- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 22 Jul 2011 07:24:53 +0000
- To: public-html-commits@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 UTC