[html5] r3406 - [] (0) Remove hasFeature() support.

[whatwg at whatwg.org]

Author: ianh
Date: 2009-07-13 22:45:24 -0700 (Mon, 13 Jul 2009)
New Revision: 3406

Modified:
   index
   source
Log:
[] (0) Remove hasFeature() support.

Modified: index
===================================================================
--- index	2009-07-14 05:27:25 UTC (rev 3405)
+++ index	2009-07-14 05:45:24 UTC (rev 3406)
@@ -6169,30 +6169,22 @@
   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=#refsDOM3CORE>[DOM3CORE]</a></p>
 
-  <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>
+  <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.</p>
 
-  <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>
+  <div class=impl>
 
-  <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>".</p>
+  <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

Modified: source
===================================================================
--- source	2009-07-14 05:27:25 UTC (rev 3405)
+++ source	2009-07-14 05:45:24 UTC (rev 3406)
@@ -6075,37 +6075,23 @@
   href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMFeatures">feature
   strings</a>. <a href="#refsDOM3CORE">[DOM3CORE]</a></p>
 
-  <p>A DOM application can use the <dfn
-  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>hasFeature</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>
+  <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.</p>
 
-  <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>
+  <div class="impl">
 
-  <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>".</p>
+  <p>For historical reasons, user agents should return the true value
+  when the <dfn 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>Exceptions</h4>
 
   <p>The following <code>DOMException</code> codes are defined in DOM