method html:Window.find is poorly documented

[DartBot]

This issue was originally filed by alexe.kaigorodov@gmail.com

---

What is the sense of parameter "backwards"? Its existence make me think that the searching starts from some point inside the window, not always from the very beginning. If it is so, it should be clearly stated.

The following code

  var text = 'text';
  document.body.append(new Text(text));
  bool res1=window.find(text, false, false, false, false, false, false);
  bool res2=window.find(text, false, false, false, false, false, false);
  print("res1=$res1 res2=$res2");

prints "res1=true res2=false"

which supports this hypothesis. If so, then if we change second search with backward search:

  bool res2=window.find(text, false, false, false, false, false, false);

res2 should be true, but its is not.

[DartBot]

This comment was originally written by alexe.kaigorodov@gmail.com

---

Correction: should read:

which can be explained with hypothesis that the search point is where the previous search ended. If so, then if we change second search with backward search:

  bool res2=window.find(text, false, true, false, false, false, false);

res2 should be true, but it is still false.

[lrhn]

Added Area-HTML, Triaged labels.

[kevmoo]

Removed Area-HTML label.
Added Area-Library, Library-Html labels.

[alan-knight]

Documentation issue. I note that the doc points to the MDN docs for the function, which seems to be identical, and which there's a pending issue to remove it, since it's non-portable, hard to use, and buggy.

---

Removed Type-Defect label.
Added Type-Documentation label.