[] (0) Drop the attempt at speccing the legacy window.find() API.

Affected topics: DOM APIs, HTML git-svn-id: http://svn.whatwg.org/webapps@7161 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jun 29, 2012 · 27ba46c · 27ba46c
1 parent 638e2b9
commit 27ba46c
Show file tree

Hide file tree

Showing 3 changed files with 2 additions and 208 deletions.
diff --git a/complete.html b/complete.html
@@ -997,8 +997,7 @@ <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 29 June 2012</h2>
      <li><a href=#dndevents><span class=secno>8.7.6 </span>Events summary</a></li>
      <li><a href=#the-draggable-attribute><span class=secno>8.7.7 </span>The <code>draggable</code> attribute</a></li>
      <li><a href=#the-dropzone-attribute><span class=secno>8.7.8 </span>The <code>dropzone</code> attribute</a></li>
-     <li><a href=#security-risks-in-the-drag-and-drop-model><span class=secno>8.7.9 </span>Security risks in the drag-and-drop model</a></ol></li>
-   <li><a href=#text-search-apis><span class=secno>8.8 </span>Text search APIs</a></ol></li>
+     <li><a href=#security-risks-in-the-drag-and-drop-model><span class=secno>8.7.9 </span>Security risks in the drag-and-drop model</a></ol></ol></li>
  <li><a href=#workers><span class=secno>9 </span>Web workers</a>
   <ol>
    <li><a href=#introduction-9><span class=secno>9.1 </span>Introduction</a>
@@ -1538,7 +1537,6 @@ <h6 class=no-toc id=how-do-the-whatwg-and-w3c-specifications-differ?><span class
    <li>The <code title=attr-inert><a href=#the-inert-attribute>inert</a></code> global attribute to disable subtrees.</li><!--INERT-->
    <li>The <code title=attr-fs-method-dialog-keyword><a href=#attr-fs-method-dialog-keyword>dialog</a></code> keyword on the <code><a href=#the-form-element>form</a></code> element's <code title=attr-fs-method><a href=#attr-fs-method>method</a></code> attribute, for a simpler way to close dialogs.</li><!--FORM-DIALOG-->
    <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <a href=#css-element-reference-identifier title="CSS element reference identifier">CSS element reference identifiers</a>.</li> <!--CSSREF-->
-   <li>An experimental specification of the legacy <code title=dom-find><a href=#dom-find>window.find()</a></code> API.</li><!--FIND-->
    <li>Some predefined <a href=#mdvocabs>Microdata vocabularies</a>.</li>
    <li>The <code><a href=#the-data-element>data</a></code> element for marking up machine-readable data.</li><!--DATA--><!--FORK-->
    <li>The <code title=scheme-http+aes><a href=#http+aes-scheme>http+aes:</a></code> and <code title=scheme-http+aes><a href=#http+aes-scheme>https+aes:</a></code> schemes.</li><!--FORK-->
@@ -65563,9 +65561,6 @@ <h3 id=the-window-object><span class=secno>6.2 </span>The <code><a href=#window>
            attribute DOMString <a href=#dom-name title=dom-name>name</a>; <!-- not [Replaceable] per WebKit and IE8 -->
   [PutForwards=<a href=#dom-location-href title=dom-location-href>href</a>, Unforgeable] readonly attribute <a href=#location>Location</a> <a href=#dom-location title=dom-location>location</a>;
   readonly attribute <a href=#history-0>History</a> <a href=#dom-history title=dom-history>history</a>;
-<!--FIND-->
-  boolean <a href=#dom-find title=dom-find>find</a>(optional DOMString aString, optional boolean aCaseSensitive, optional boolean aBackwards, optional boolean aWrapAround, optional boolean aWholeWord, optional boolean aSearchInFrames, optional boolean aShowDialog);
-<!--FIND-->
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-locationbar title=dom-window-locationbar>locationbar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-menubar title=dom-window-menubar>menubar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-personalbar title=dom-window-personalbar>personalbar</a>;
@@ -79107,70 +79102,6 @@ <h4 id=security-risks-in-the-drag-and-drop-model><span class=secno>8.7.9 </span>
 <!--REMOVE-TOPIC:Security-->
 
 
-<!--FIND-->
-<!--TOPIC:DOM APIs-->
-  <h3 id=text-search-apis><span class=secno>8.8 </span>Text search APIs</h3> <!-- window.find() -->
-
-  <p class=critical>This legacy API is not very interoperably
-  implemented, and has a number of design problems (such as having six
-  boolean arguments in a row, giving the ability to expose a UA
-  dialog, affecting the selection when successful, etc). We may just
-  drop it instead.</p>
-
-  <!-- use case seems to be to just have an API that allows scripts to
-  search for text, then manipulate it (e.g. execCommand).
-  Unfortunately it currently destroys the selection to do so (though I
-  guess you can save it and restore it). We could provide an API for
-  this instead, but it would require changes to execCommand() to work
-  on ranges rather than the selection (probably needed anyway, but not
-  being worked on as of now) -->
-
-  <!-- demo: http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1076 -->
-
-  <!-- bugs:
-
-     https://bugzilla.mozilla.org/show_bug.cgi?id=672395
-     https://bugs.webkit.org/show_bug.cgi?id=64761
-
-  -->
-
-  <!-- notes:
-
-   if first argument is '', gecko throws a dialog. webkit does not.
-
-   aCaseSensitive, if true, matches case.
-   Webkit: If false, even if the search string is the equivalent of c&aring;t, it'll still match "cat".
-   Gecko: some sort of unicode case-insensitive (aring matches Aring)
-
-   search starts from the last place the user placed the invisible cursor
-
-   once find() has selected text in a text field, it acts as if the cursor jumps back to the top of the page
-
-   aWholeWord has no effect.
-
-   Gecko: aWrapAround has no effect.
-   WebKit: aWrapAround works by wrapping around at the bottom of the page (top if going backwards).
-
-   Gecko: searches iframes if aSearchInFrames is set
-   WebKit: doesn't search iframes; aSearchInFrames has no effect.
-
-   Gecko: aShowDialog works
-   Webkit: does not
-
-   Gecko: doesn't work on display:none iframes. (works fine in webkit)
-   WebKit: doesn't work before body.onload has fired or some such (works fine in gecko)
-
-  -->
-
-  <!--
-  boolean <span title="dom-find">find</span>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional aWholeWord, in optional aSearchInFrames, in optional aShowDialog);
-  -->
-
-  <p class=XXX><dfn id=dom-find title=dom-find>window.find()</dfn> goes here</p>
-
-<!--FIND-->
-
-
 
 
 

diff --git a/index b/index
@@ -997,8 +997,7 @@
      <li><a href=#dndevents><span class=secno>8.7.6 </span>Events summary</a></li>
      <li><a href=#the-draggable-attribute><span class=secno>8.7.7 </span>The <code>draggable</code> attribute</a></li>
      <li><a href=#the-dropzone-attribute><span class=secno>8.7.8 </span>The <code>dropzone</code> attribute</a></li>
-     <li><a href=#security-risks-in-the-drag-and-drop-model><span class=secno>8.7.9 </span>Security risks in the drag-and-drop model</a></ol></li>
-   <li><a href=#text-search-apis><span class=secno>8.8 </span>Text search APIs</a></ol></li>
+     <li><a href=#security-risks-in-the-drag-and-drop-model><span class=secno>8.7.9 </span>Security risks in the drag-and-drop model</a></ol></ol></li>
  <li><a href=#workers><span class=secno>9 </span>Web workers</a>
   <ol>
    <li><a href=#introduction-9><span class=secno>9.1 </span>Introduction</a>
@@ -1538,7 +1537,6 @@
    <li>The <code title=attr-inert><a href=#the-inert-attribute>inert</a></code> global attribute to disable subtrees.</li><!--INERT-->
    <li>The <code title=attr-fs-method-dialog-keyword><a href=#attr-fs-method-dialog-keyword>dialog</a></code> keyword on the <code><a href=#the-form-element>form</a></code> element's <code title=attr-fs-method><a href=#attr-fs-method>method</a></code> attribute, for a simpler way to close dialogs.</li><!--FORM-DIALOG-->
    <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <a href=#css-element-reference-identifier title="CSS element reference identifier">CSS element reference identifiers</a>.</li> <!--CSSREF-->
-   <li>An experimental specification of the legacy <code title=dom-find><a href=#dom-find>window.find()</a></code> API.</li><!--FIND-->
    <li>Some predefined <a href=#mdvocabs>Microdata vocabularies</a>.</li>
    <li>The <code><a href=#the-data-element>data</a></code> element for marking up machine-readable data.</li><!--DATA--><!--FORK-->
    <li>The <code title=scheme-http+aes><a href=#http+aes-scheme>http+aes:</a></code> and <code title=scheme-http+aes><a href=#http+aes-scheme>https+aes:</a></code> schemes.</li><!--FORK-->
@@ -65563,9 +65561,6 @@ interface <dfn id=window>Window</dfn> : <a href=#eventtarget>EventTarget</a> {
            attribute DOMString <a href=#dom-name title=dom-name>name</a>; <!-- not [Replaceable] per WebKit and IE8 -->
   [PutForwards=<a href=#dom-location-href title=dom-location-href>href</a>, Unforgeable] readonly attribute <a href=#location>Location</a> <a href=#dom-location title=dom-location>location</a>;
   readonly attribute <a href=#history-0>History</a> <a href=#dom-history title=dom-history>history</a>;
-<!--FIND-->
-  boolean <a href=#dom-find title=dom-find>find</a>(optional DOMString aString, optional boolean aCaseSensitive, optional boolean aBackwards, optional boolean aWrapAround, optional boolean aWholeWord, optional boolean aSearchInFrames, optional boolean aShowDialog);
-<!--FIND-->
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-locationbar title=dom-window-locationbar>locationbar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-menubar title=dom-window-menubar>menubar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-personalbar title=dom-window-personalbar>personalbar</a>;
@@ -79107,70 +79102,6 @@ dictionary <dfn id=drageventinit>DragEventInit</dfn> : <a href=#mouseeventinit>M
 <!--REMOVE-TOPIC:Security-->
 
 
-<!--FIND-->
-<!--TOPIC:DOM APIs-->
-  <h3 id=text-search-apis><span class=secno>8.8 </span>Text search APIs</h3> <!-- window.find() -->
-
-  <p class=critical>This legacy API is not very interoperably
-  implemented, and has a number of design problems (such as having six
-  boolean arguments in a row, giving the ability to expose a UA
-  dialog, affecting the selection when successful, etc). We may just
-  drop it instead.</p>
-
-  <!-- use case seems to be to just have an API that allows scripts to
-  search for text, then manipulate it (e.g. execCommand).
-  Unfortunately it currently destroys the selection to do so (though I
-  guess you can save it and restore it). We could provide an API for
-  this instead, but it would require changes to execCommand() to work
-  on ranges rather than the selection (probably needed anyway, but not
-  being worked on as of now) -->
-
-  <!-- demo: http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1076 -->
-
-  <!-- bugs:
-
-     https://bugzilla.mozilla.org/show_bug.cgi?id=672395
-     https://bugs.webkit.org/show_bug.cgi?id=64761
-
-  -->
-
-  <!-- notes:
-
-   if first argument is '', gecko throws a dialog. webkit does not.
-
-   aCaseSensitive, if true, matches case.
-   Webkit: If false, even if the search string is the equivalent of c&aring;t, it'll still match "cat".
-   Gecko: some sort of unicode case-insensitive (aring matches Aring)
-
-   search starts from the last place the user placed the invisible cursor
-
-   once find() has selected text in a text field, it acts as if the cursor jumps back to the top of the page
-
-   aWholeWord has no effect.
-
-   Gecko: aWrapAround has no effect.
-   WebKit: aWrapAround works by wrapping around at the bottom of the page (top if going backwards).
-
-   Gecko: searches iframes if aSearchInFrames is set
-   WebKit: doesn't search iframes; aSearchInFrames has no effect.
-
-   Gecko: aShowDialog works
-   Webkit: does not
-
-   Gecko: doesn't work on display:none iframes. (works fine in webkit)
-   WebKit: doesn't work before body.onload has fired or some such (works fine in gecko)
-
-  -->
-
-  <!--
-  boolean <span title="dom-find">find</span>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional aWholeWord, in optional aSearchInFrames, in optional aShowDialog);
-  -->
-
-  <p class=XXX><dfn id=dom-find title=dom-find>window.find()</dfn> goes here</p>
-
-<!--FIND-->
-
-
 
 
 

diff --git a/source b/source
@@ -268,7 +268,6 @@
    <li>The <code title="attr-inert">inert</code> global attribute to disable subtrees.</li><!--INERT-->
    <li>The <code title="attr-fs-method-dialog-keyword">dialog</code> keyword on the <code>form</code> element's <code title="attr-fs-method">method</code> attribute, for a simpler way to close dialogs.</li><!--FORM-DIALOG-->
    <li>The <code title="dom-document-cssElementMap">cssElementMap</code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
-   <li>An experimental specification of the legacy <code title="dom-find">window.find()</code> API.</li><!--FIND-->
    <li>Some predefined <a href="#mdvocabs">Microdata vocabularies</a>.</li>
    <li>The <code>data</code> element for marking up machine-readable data.</li><!--DATA--><!--FORK-->
    <li>The <code title="scheme-http+aes">http+aes:</code> and <code title="scheme-http+aes">https+aes:</code> schemes.</li><!--FORK-->
@@ -76870,9 +76869,6 @@ interface <dfn>Window</dfn> : <span>EventTarget</span> {
            attribute DOMString <span title="dom-name">name</span>; <!-- not [Replaceable] per WebKit and IE8 -->
   [PutForwards=<span title="dom-location-href">href</span>, Unforgeable] readonly attribute <span>Location</span> <span title="dom-location">location</span>;
   readonly attribute <span>History</span> <span title="dom-history">history</span>;
-<!--END w3c-html--><!--FIND-->
-  boolean <span title="dom-find">find</span>(optional DOMString aString, optional boolean aCaseSensitive, optional boolean aBackwards, optional boolean aWrapAround, optional boolean aWholeWord, optional boolean aSearchInFrames, optional boolean aShowDialog);
-<!--START w3c-html--><!--FIND-->
   [Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-locationbar">locationbar</span>;
   [Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-menubar">menubar</span>;
   [Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-personalbar">personalbar</span>;
@@ -92660,73 +92656,9 @@ dictionary <dfn>DragEventInit</dfn> : <span>MouseEventInit</span> {
 <!--REMOVE-TOPIC:Security-->
 
 
-<!--END w3c-html--><!--FIND-->
-<!--TOPIC:DOM APIs-->
-  <h3>Text search APIs</h3> <!-- window.find() -->
-
-  <p class="critical">This legacy API is not very interoperably
-  implemented, and has a number of design problems (such as having six
-  boolean arguments in a row, giving the ability to expose a UA
-  dialog, affecting the selection when successful, etc). We may just
-  drop it instead.</p>
-
-  <!-- use case seems to be to just have an API that allows scripts to
-  search for text, then manipulate it (e.g. execCommand).
-  Unfortunately it currently destroys the selection to do so (though I
-  guess you can save it and restore it). We could provide an API for
-  this instead, but it would require changes to execCommand() to work
-  on ranges rather than the selection (probably needed anyway, but not
-  being worked on as of now) -->
-
-  <!-- demo: http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1076 -->
-
-  <!-- bugs:
-
-     https://bugzilla.mozilla.org/show_bug.cgi?id=672395
-     https://bugs.webkit.org/show_bug.cgi?id=64761
-
-  -->
-
-  <!-- notes:
-
-   if first argument is '', gecko throws a dialog. webkit does not.
-
-   aCaseSensitive, if true, matches case.
-   Webkit: If false, even if the search string is the equivalent of c&aring;t, it'll still match "cat".
-   Gecko: some sort of unicode case-insensitive (aring matches Aring)
-
-   search starts from the last place the user placed the invisible cursor
-
-   once find() has selected text in a text field, it acts as if the cursor jumps back to the top of the page
-
-   aWholeWord has no effect.
-
-   Gecko: aWrapAround has no effect.
-   WebKit: aWrapAround works by wrapping around at the bottom of the page (top if going backwards).
-
-   Gecko: searches iframes if aSearchInFrames is set
-   WebKit: doesn't search iframes; aSearchInFrames has no effect.
-
-   Gecko: aShowDialog works
-   Webkit: does not
-
-   Gecko: doesn't work on display:none iframes. (works fine in webkit)
-   WebKit: doesn't work before body.onload has fired or some such (works fine in gecko)
-
-  -->
-
-  <!--
-  boolean <span title="dom-find">find</span>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional aWholeWord, in optional aSearchInFrames, in optional aShowDialog);
-  -->
-
-  <p class="XXX"><dfn title="dom-find">window.find()</dfn> goes here</p>
-
-<!--START w3c-html--><!--FIND-->
 
 <!--END dev-html--><!--END w3c-html-->
 
-
-
   <div data-component="Web Workers (editor: Ian Hickson)"><!--TOPIC:Web Workers-->
 
   <h2 id="workers">Web workers</h2>