[] (0) Remove hasFeature() support.

git-svn-id: http://svn.whatwg.org/webapps@3406 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jul 14, 2009 · 452a6d4 · 452a6d4
1 parent 6944f9a
commit 452a6d4
Show file tree

Hide file tree

Showing 2 changed files with 29 additions and 51 deletions.
diff --git a/index b/index
@@ -6169,28 +6169,20 @@ interface <dfn id=domstringmap-0>DOMStringMap</dfn> {};</pre>
   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 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>
-
-  <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>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>
+
+  <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>

diff --git a/source b/source
@@ -6075,35 +6075,21 @@ interface <dfn>DOMStringMap</dfn> {};</pre>
   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 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>
-
-  <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>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>
+
+  <div class="impl">
+
+  <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>