Regenerate docs and remove missing file from example to let grind test pass (#1331)

Author: jcollins-g

testing/test_package/lib/example.dart

@@ -222,8 +222,6 @@ class ConstantCat implements Cat {
 /// {@example dog/food}
 /// {@example dog/food.txt region=meat}
 ///
-/// {@example test.html}
-///
 /// {@example test.dart region=template lang=html}
 ///
 /// {@example test.dart region=}

testing/test_package_docs/ex/Dog-class.html

@@ -144,8 +144,6 @@ <h5><a href="ex/ex-library.html">ex</a></h5>
 A selection of dog flavors:</p><ul><li>beef</li><li>poultry</li></ul>
 <pre class="language-html prettyprint"><code class="language-html">&lt;h1&gt;Hello &lt;b&gt;World&lt;/b&gt;!&lt;/h1&gt;
 </code></pre>
-<pre class="language-html prettyprint"><code class="language-html">&lt;h1&gt;Hello &lt;b&gt;World&lt;/b&gt;!&lt;/h1&gt;
-</code></pre>
 <pre class="language-dart prettyprint"><code class="language-dart">var test = 1;
 </code></pre>
 <pre class="prettyprint language-dart"><code>var test = 1;

testing/test_package_docs/fake/ExtraSpecialList/fillRange.html

@@ -155,7 +155,10 @@ <h5><a href="fake/ExtraSpecialList-class.html">ExtraSpecialList</a></h5>
     <section class="desc markdown">
       <p>Sets the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
 to the given <code>fillValue</code>.</p>
-<p>An error occurs if <code>start</code>..<code>end</code> is not a valid range for <code>this</code>.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid.
+A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
     </section>
 
 

testing/test_package_docs/fake/ExtraSpecialList/getRange.html

@@ -155,11 +155,13 @@ <h5><a href="fake/ExtraSpecialList-class.html">ExtraSpecialList</a></h5>
     <section class="desc markdown">
       <p>Returns an <code>Iterable</code> that iterates over the objects in the range
 <code>start</code> inclusive to <code>end</code> exclusive.</p>
-<p>An error occurs if <code>end</code> is before <code>start</code>.</p>
-<p>An error occurs if the <code>start</code> and <code>end</code> are not valid ranges at the time
-of the call to this method. The returned <code>Iterable</code> behaves like
-<code>skip(start).take(end - start)</code>. That is, it does not throw exceptions
-if <code>this</code> changes size.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid at the time
+of the call.</p>
+<p>A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
+<p>The returned <code>Iterable</code> behaves like <code>skip(start).take(end - start)</code>.
+That is, it does <em>not</em> throw if this list changes size.</p>
 <pre class="prettyprint language-dart"><code>List&lt;String&gt; colors = ['red', 'green', 'blue', 'orange', 'pink'];
 Iterable&lt;String&gt; range = colors.getRange(1, 4);
 range.join(', ');  // 'green, blue, orange'

testing/test_package_docs/fake/ExtraSpecialList/removeRange.html

@@ -154,8 +154,10 @@ <h5><a href="fake/ExtraSpecialList-class.html">ExtraSpecialList</a></h5>
     </section>
     <section class="desc markdown">
       <p>Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive.</p>
-<p>The <code>start</code> and <code>end</code> indices must be in the range
-<code>0 ≤ index ≤ length</code>, and <code>start ≤ end</code>.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid.
+A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
 <p>Throws an <code>UnsupportedError</code> if this is a fixed-length list. In that case
 the list is not modified.</p>
     </section>

testing/test_package_docs/fake/ExtraSpecialList/replaceRange.html

@@ -159,7 +159,10 @@ <h5><a href="fake/ExtraSpecialList-class.html">ExtraSpecialList</a></h5>
 list.replaceRange(1, 4, [6, 7]);
 list.join(', '); // '1, 6, 7, 5'
 </code></pre>
-<p>An error occurs if <code>start</code>..<code>end</code> is not a valid range for <code>this</code>.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid.
+A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
 <p>This method does not work on fixed-length lists, even when <code>replacement</code>
 has the same number of elements as the replaced range. In that case use
 <code>setRange</code> instead.</p>

testing/test_package_docs/fake/ExtraSpecialList/setRange.html

@@ -162,13 +162,15 @@ <h5><a href="fake/ExtraSpecialList-class.html">ExtraSpecialList</a></h5>
 list1.setRange(1, 3, list2, 3);
 list1.join(', '); // '1, 8, 9, 4'
 </code></pre>
-<p>The <code>start</code> and <code>end</code> indices must satisfy <code>0 ≤ start ≤ end ≤ length</code>.
-If <code>start</code> equals <code>end</code>, this method has no effect.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid.
+A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
 <p>The <code>iterable</code> must have enough objects to fill the range from <code>start</code>
 to <code>end</code> after skipping <code>skipCount</code> objects.</p>
-<p>If <code>iterable</code> is this list, the operation will copy the elements originally
-in the range from <code>skipCount</code> to <code>skipCount + (end - start)</code> to the
-range <code>start</code> to <code>end</code>, even if the two ranges overlap.</p>
+<p>If <code>iterable</code> is this list, the operation will copies the elements
+originally in the range from <code>skipCount</code> to <code>skipCount + (end - start)</code> to
+the range <code>start</code> to <code>end</code>, even if the two ranges overlap.</p>
 <p>If <code>iterable</code> depends on this list in some other way, no guarantees are
 made.</p>
     </section>

testing/test_package_docs/fake/SpecialList/fillRange.html

@@ -155,7 +155,10 @@ <h5><a href="fake/SpecialList-class.html">SpecialList</a></h5>
     <section class="desc markdown">
       <p>Sets the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
 to the given <code>fillValue</code>.</p>
-<p>An error occurs if <code>start</code>..<code>end</code> is not a valid range for <code>this</code>.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid.
+A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
     </section>
 
 

testing/test_package_docs/fake/SpecialList/getRange.html

@@ -155,11 +155,13 @@ <h5><a href="fake/SpecialList-class.html">SpecialList</a></h5>
     <section class="desc markdown">
       <p>Returns an <code>Iterable</code> that iterates over the objects in the range
 <code>start</code> inclusive to <code>end</code> exclusive.</p>
-<p>An error occurs if <code>end</code> is before <code>start</code>.</p>
-<p>An error occurs if the <code>start</code> and <code>end</code> are not valid ranges at the time
-of the call to this method. The returned <code>Iterable</code> behaves like
-<code>skip(start).take(end - start)</code>. That is, it does not throw exceptions
-if <code>this</code> changes size.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid at the time
+of the call.</p>
+<p>A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
+<p>The returned <code>Iterable</code> behaves like <code>skip(start).take(end - start)</code>.
+That is, it does <em>not</em> throw if this list changes size.</p>
 <pre class="prettyprint language-dart"><code>List&lt;String&gt; colors = ['red', 'green', 'blue', 'orange', 'pink'];
 Iterable&lt;String&gt; range = colors.getRange(1, 4);
 range.join(', ');  // 'green, blue, orange'

testing/test_package_docs/fake/SpecialList/removeRange.html

@@ -154,8 +154,10 @@ <h5><a href="fake/SpecialList-class.html">SpecialList</a></h5>
     </section>
     <section class="desc markdown">
       <p>Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive.</p>
-<p>The <code>start</code> and <code>end</code> indices must be in the range
-<code>0 ≤ index ≤ length</code>, and <code>start ≤ end</code>.</p>
+<p>The provide range, given by <code>start</code> and <code>end</code>, must be valid.
+A range from <code>start</code> to <code>end</code> is valid if <code>0 &lt;= start &lt;= end &lt;= len</code>, where
+<code>len</code> is this list's <code>length</code>. The range starts at <code>start</code> and has length
+<code>end - start</code>. An empty range (with <code>end == start</code>) is valid.</p>
 <p>Throws an <code>UnsupportedError</code> if this is a fixed-length list. In that case
 the list is not modified.</p>
     </section>