- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 14 Jul 2009 05:45:33 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv21596
Modified Files:
Overview.html
Log Message:
Remove hasFeature() support. (whatwg r3406)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2535
retrieving revision 1.2536
diff -u -d -r1.2535 -r1.2536
--- Overview.html 14 Jul 2009 05:27:30 -0000 1.2535
+++ Overview.html 14 Jul 2009 05:45:29 -0000 1.2536
@@ -5592,24 +5592,18 @@
</div><h4 id="dom-feature-strings"><span class="secno">2.8.7 </span>DOM feature strings</h4><p>DOM3 Core defines mechanisms for checking for interface support,
and for obtaining implementations of interfaces, using <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMFeatures">feature
- strings</a>. <a href="#references">[DOM3CORE]</a><p>A DOM application can use the <dfn id="hasfeature" title="hasFeature"><code>hasFeature(<var title="">feature</var>,
- <var title="">version</var>)</code></dfn> method of the
- <code>DOMImplementation</code> interface with parameter values
- "<code title="">HTML</code>" and "<code>5.0</code>" (respectively)
- to determine whether or not this module is supported by the
- implementation. In addition to the feature string "<code title="">HTML</code>", the feature string "<code title="">XHTML</code>" (with version string "<code>5.0</code>") can
- be used to check if the implementation supports XHTML. <span class="impl">User agents should respond with a true value when the
- <code><a href="#hasfeature">hasFeature</a></code> method is queried with these values.</span>
- Authors are cautioned, however, that UAs returning true might not be
- perfectly compliant, and that UAs returning false might well have
- support for features in this specification; in general, therefore,
- use of this method is discouraged.<p class="impl">The values "<code title="">HTML</code>" and "<code title="">XHTML</code>" (both with version "<code>5.0</code>") should
- also be supported in the context of the <code>getFeature()</code>
- and <code>isSupported()</code> methods, as defined by DOM3 Core.<p class="note">The interfaces defined in this specification are not
- always supersets of the interfaces defined in DOM2 HTML; some
- features that were formerly deprecated, poorly supported, rarely
- used or considered unnecessary have been removed. Therefore it is
- not guaranteed that an implementation that supports "<code title="">HTML</code>" "<code>5.0</code>" also supports "<code title="">HTML</code>" "<code>2.0</code>".<h4 id="exceptions"><span class="secno">2.8.8 </span>Exceptions</h4><p>The following <code>DOMException</code> codes are defined in DOM
+ strings</a>. <a href="#references">[DOM3CORE]</a><p>Authors are strongly discouraged from using these, as they are
+ notoriously unreliable and imprecise. Authors are encouraged to rely
+ on explicit feature testing or the graceful degradation behavior
+ intrinsic to some of the features in this specification.<div class="impl">
+
+ <p>For historical reasons, user agents should return the true value
+ when the <dfn id="hasfeature" title="hasFeature"><code>hasFeature(<var title="">feature</var>, <var title="">version</var>)</code></dfn>
+ method of the <code>DOMImplementation</code> interface is invoked
+ with parameter values "<code title="">HTML</code>" and
+ "<code>2.0</code>" (respectively).</p>
+
+ </div><h4 id="exceptions"><span class="secno">2.8.8 </span>Exceptions</h4><p>The following <code>DOMException</code> codes are defined in DOM
Core. <a href="#references">[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>
Received on Tuesday, 14 July 2009 05:45:43 UTC