Update website

6 files changed, 1637 insertions, 716 deletions

diff --git a/download/index.html b/download/index.html
index 6cb5efdc..e8325b5e 100644
--- a/download/index.html
+++ b/download/index.html
@@ -235,7 +235,7 @@ the signature and running <code>gpg --verify signature.asc</code>.</p>
 </ul>
 <p>You can build it using the usual <code>./configure &amp;&amp; make &amp;&amp; sudo
 make install</code> rigmarole.</p>
-<p>If you're interested in using the lastest development version, try:</p>
+<p>If you're interested in using the latest development version, try:</p>
 <pre><code>git clone --recursive https://github.com/jqlang/jq.git
 cd jq
 autoreconf -i
diff --git a/manual/index.html b/manual/index.html
index a2d65c95..b66fe23b 100644
--- a/manual/index.html
+++ b/manual/index.html
@@ -155,8 +155,8 @@ simpler:</p>
               <p>jq filters run on a stream of JSON data. The input to jq is
 parsed as a sequence of whitespace-separated JSON values which
 are passed through the provided filter one at a time. The
-output(s) of the filter are written to standard out, again as a
-sequence of whitespace-separated JSON data.</p>
+output(s) of the filter are written to standard output, as a
+sequence of newline-separated JSON data.</p>
 <p>Note: it is important to mind the shell's quoting rules.  As a
 general rule it's best to always quote (with single-quote
 characters) the jq program, as too many characters with special
@@ -206,7 +206,7 @@ using some command-line options:</p>
 <ul>
 <li><code>--stream-errors</code>:</li>
 </ul>
-<p>Like <code>--stream</code>, but invalid JSON inputs yield array calues
+<p>Like <code>--stream</code>, but invalid JSON inputs yield array values
   where the first element is the error and the second is a path.
   For example, <code>["a",n]</code> produces ["Invalid literal at line 1,
   column 9",[1]]`.</p>
@@ -538,7 +538,7 @@ illustrated in one of the following examples.</p>
                   <p>The simplest <em>useful</em> filter has the form <code>.foo</code>. When given a
 JSON object (aka dictionary or hash) as input, <code>.foo</code> produces
 the value at the key "foo" if the key is present, or null otherwise.</p>
-<p>A filter of the form <code>.foo.bar</code> is equivalent to <code>.foo|.bar</code>.</p>
+<p>A filter of the form <code>.foo.bar</code> is equivalent to <code>.foo | .bar</code>.</p>
 <p>The <code>.foo</code> syntax only works for simple, identifier-like keys, that
 is, keys that are all made of alphanumeric characters and
 underscore, and which do not start with a digit.</p>
@@ -772,7 +772,8 @@ returned by <code>.[10:15]</code> will be of length 5, containing the
 elements from index 10 (inclusive) to index 15 (exclusive).
 Either index may be negative (in which case it counts
 backwards from the end of the array), or omitted (in which
-case it refers to the start or end of the array).</p>
+case it refers to the start or end of the array).
+Indices are zero-based.</p>
 
                   
                     <div>
@@ -853,7 +854,8 @@ case it refers to the start or end of the array).</p>
 entirely, it will return <em>all</em> of the elements of an
 array. Running <code>.[]</code> with the input <code>[1,2,3]</code> will produce the
 numbers as three separate results, rather than as a single
-array.</p>
+array. A filter of the form <code>.foo[]</code> is equivalent to
+<code>.foo | .[]</code>.</p>
 <p>You can also use this on an object, and it will return all
 the values of the object.</p>
 
@@ -900,6 +902,34 @@ the values of the object.</p>
                           </table>
                         
                           <table>
+                            <tr><th></th><td class="jqprogram">jq '.foo[]'</td></tr>
+                            <tr><th>Input</th><td>{&#34;foo&#34;:[1,2,3]}</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>1</td>
+                              </tr>
+                            
+                              <tr>
+                                
+                                  <th></th>
+                                
+                                <td>2</td>
+                              </tr>
+                            
+                              <tr>
+                                
+                                  <th></th>
+                                
+                                <td>3</td>
+                              </tr>
+                            
+                          </table>
+                        
+                          <table>
                             <tr><th></th><td class="jqprogram">jq '.[]'</td></tr>
                             <tr><th>Input</th><td>{&#34;a&#34;: 1, &#34;b&#34;: 1}</td></tr>
                             
@@ -931,7 +961,8 @@ the values of the object.</p>
                     
                   </h3>
                   <p>Like <code>.[]</code>, but no errors will be output if . is not an array
-or object.</p>
+or object. A filter of the form <code>.foo[]?</code> is equivalent to
+<code>.foo | .[]?</code>.</p>
 
                   
                 </section>
@@ -1319,8 +1350,8 @@ key and its value becomes the value,</p>
                   <p>Recursively descends <code>.</code>, producing every value.  This is the
 same as the zero-argument <code>recurse</code> builtin (see below).  This
 is intended to resemble the XPath <code>//</code> operator.  Note that
-<code>..a</code> does not work; use <code>..|.a</code> instead.  In the example
-below we use <code>..|.a?</code> to find all the values of object keys
+<code>..a</code> does not work; use <code>.. | .a</code> instead.  In the example
+below we use <code>.. | .a?</code> to find all the values of object keys
 "a" in any object found "below" <code>.</code>.</p>
 <p>This is particularly useful in conjunction with <code>path(EXP)</code>
 (also see below) and the <code>?</code> operator.</p>
@@ -1335,7 +1366,7 @@ below we use <code>..|.a?</code> to find all the values of object keys
                       <div id="example12" class="manual-example collapse">
                         
                           <table>
-                            <tr><th></th><td class="jqprogram">jq '..|.a?'</td></tr>
+                            <tr><th></th><td class="jqprogram">jq '.. | .a?'</td></tr>
                             <tr><th>Input</th><td>[[{&#34;a&#34;:1}]]</td></tr>
                             
                             
@@ -2570,16 +2601,58 @@ non-iterables, respectively.</p>
                   
                 </section>
               
-                <section id="error(message)">
+                <section id="error,error(message)">
                   <h3>
-                    <code>error(message)</code>
+                    <code>error</code>, <code>error(message)</code>
                     
                   </h3>
-                  <p>Produces an error, just like <code>.a</code> applied to values other than
-null and objects would, but with the given message as the
-error's value.  Errors can be caught with try/catch; see below.</p>
+                  <p>Produces an error with the input value, or with the message
+given as the argument. Errors can be caught with try/catch;
+see below.</p>
+<p>When the error value is <code>null</code>, it produces nothing and works
+just like <code>empty</code>. So <code>[null | error]</code> and <code>[error(null)]</code> both
+emit <code>[]</code>.</p>
 
                   
+                    <div>
+                      
+                      <a data-toggle="collapse" href="#example32">
+                        <i class="glyphicon glyphicon-chevron-right"></i>
+                        Examples
+                      </a>
+                      <div id="example32" class="manual-example collapse">
+                        
+                          <table>
+                            <tr><th></th><td class="jqprogram">jq 'try error catch .'</td></tr>
+                            <tr><th>Input</th><td>&#34;error message&#34;</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>&#34;error message&#34;</td>
+                              </tr>
+                            
+                          </table>
+                        
+                          <table>
+                            <tr><th></th><td class="jqprogram">jq 'try error(&#34;invalid value: \(.)&#34;) catch .'</td></tr>
+                            <tr><th>Input</th><td>42</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>&#34;invalid value: 42&#34;</td>
+                              </tr>
+                            
+                          </table>
+                        
+                      </div>
+                    </div>
+                  
                 </section>
               
                 <section id="halt">
@@ -2620,11 +2693,11 @@ values.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example32">
+                      <a data-toggle="collapse" href="#example33">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example32" class="manual-example collapse">
+                      <div id="example33" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'try error(&#34;\($__loc__)&#34;) catch .'</td></tr>
@@ -2660,11 +2733,11 @@ values.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example33">
+                      <a data-toggle="collapse" href="#example34">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example33" class="manual-example collapse">
+                      <div id="example34" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '[paths]'</td></tr>
@@ -2714,11 +2787,11 @@ as those for the <code>+</code> operator (described above).</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example34">
+                      <a data-toggle="collapse" href="#example35">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example34" class="manual-example collapse">
+                      <div id="example35" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'add'</td></tr>
@@ -2784,11 +2857,11 @@ condition to all the outputs of the given generator.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example35">
+                      <a data-toggle="collapse" href="#example36">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example35" class="manual-example collapse">
+                      <div id="example36" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'any'</td></tr>
@@ -2854,11 +2927,11 @@ condition to all the outputs of the given generator.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example36">
+                      <a data-toggle="collapse" href="#example37">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example36" class="manual-example collapse">
+                      <div id="example37" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'all'</td></tr>
@@ -2922,11 +2995,11 @@ levels deep.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example37">
+                      <a data-toggle="collapse" href="#example38">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example37" class="manual-example collapse">
+                      <div id="example38" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'flatten'</td></tr>
@@ -3008,11 +3081,11 @@ with an increment of <code>by</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example38">
+                      <a data-toggle="collapse" href="#example39">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example38" class="manual-example collapse">
+                      <div id="example39" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'range(2; 4)'</td></tr>
@@ -3120,11 +3193,11 @@ with an increment of <code>by</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example39">
+                      <a data-toggle="collapse" href="#example40">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example39" class="manual-example collapse">
+                      <div id="example40" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'floor'</td></tr>
@@ -3155,11 +3228,11 @@ with an increment of <code>by</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example40">
+                      <a data-toggle="collapse" href="#example41">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example40" class="manual-example collapse">
+                      <div id="example41" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'sqrt'</td></tr>
@@ -3192,11 +3265,11 @@ equivalent, leave numbers alone, and give an error on all other input.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example41">
+                      <a data-toggle="collapse" href="#example42">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example41" class="manual-example collapse">
+                      <div id="example42" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '.[] | tonumber'</td></tr>
@@ -3236,11 +3309,11 @@ JSON-encoded.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example42">
+                      <a data-toggle="collapse" href="#example43">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example42" class="manual-example collapse">
+                      <div id="example43" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '.[] | tostring'</td></tr>
@@ -3287,11 +3360,11 @@ or object.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example43">
+                      <a data-toggle="collapse" href="#example44">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example43" class="manual-example collapse">
+                      <div id="example44" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'map(type)'</td></tr>
@@ -3331,11 +3404,11 @@ NaNs, and sub-normals do not raise errors.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example44">
+                      <a data-toggle="collapse" href="#example45">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example44" class="manual-example collapse">
+                      <div id="example45" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '.[] | (infinite * .) &lt; 0'</td></tr>
@@ -3404,19 +3477,21 @@ array. Values are sorted in the following order:</p>
 compared by comparing their sets of keys (as arrays in
 sorted order), and if their keys are equal then the values
 are compared key by key.</p>
-<p><code>sort</code> may be used to sort by a particular field of an
-object, or by applying any jq filter.</p>
-<p><code>sort_by(f)</code> compares two elements by comparing the result of
-<code>f</code> on each element.</p>
+<p><code>sort_by</code> may be used to sort by a particular field of an
+object, or by applying any jq filter. <code>sort_by(f)</code> compares
+two elements by comparing the result of <code>f</code> on each element.
+When <code>f</code> produces multiple values, it firstly compares the
+first values, and the second values if the first values are
+equal, and so on.</p>
 
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example45">
+                      <a data-toggle="collapse" href="#example46">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example45" class="manual-example collapse">
+                      <div id="example46" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'sort'</td></tr>
@@ -3434,14 +3509,28 @@ object, or by applying any jq filter.</p>
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'sort_by(.foo)'</td></tr>
-                            <tr><th>Input</th><td>[{&#34;foo&#34;:4, &#34;bar&#34;:10}, {&#34;foo&#34;:3, &#34;bar&#34;:100}, {&#34;foo&#34;:2, &#34;bar&#34;:1}]</td></tr>
+                            <tr><th>Input</th><td>[{&#34;foo&#34;:4, &#34;bar&#34;:10}, {&#34;foo&#34;:3, &#34;bar&#34;:10}, {&#34;foo&#34;:2, &#34;bar&#34;:1}]</td></tr>
                             
                             
                               <tr>
                                 
                                   <th>Output</th>
                                 
-                                <td>[{&#34;foo&#34;:2, &#34;bar&#34;:1}, {&#34;foo&#34;:3, &#34;bar&#34;:100}, {&#34;foo&#34;:4, &#34;bar&#34;:10}]</td>
+                                <td>[{&#34;foo&#34;:2, &#34;bar&#34;:1}, {&#34;foo&#34;:3, &#34;bar&#34;:10}, {&#34;foo&#34;:4, &#34;bar&#34;:10}]</td>
+                              </tr>
+                            
+                          </table>
+                        
+                          <table>
+                            <tr><th></th><td class="jqprogram">jq 'sort_by(.foo, .bar)'</td></tr>
+                            <tr><th>Input</th><td>[{&#34;foo&#34;:4, &#34;bar&#34;:10}, {&#34;foo&#34;:3, &#34;bar&#34;:20}, {&#34;foo&#34;:2, &#34;bar&#34;:1}, {&#34;foo&#34;:3, &#34;bar&#34;:10}]</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>[{&#34;foo&#34;:2, &#34;bar&#34;:1}, {&#34;foo&#34;:3, &#34;bar&#34;:10}, {&#34;foo&#34;:3, &#34;bar&#34;:20}, {&#34;foo&#34;:4, &#34;bar&#34;:10}]</td>
                               </tr>
                             
                           </table>
@@ -3467,11 +3556,11 @@ in the <code>sort</code> function above.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example46">
+                      <a data-toggle="collapse" href="#example47">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example46" class="manual-example collapse">
+                      <div id="example47" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'group_by(.foo)'</td></tr>
@@ -3505,11 +3594,11 @@ you to specify a particular field or property to examine, e.g.
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example47">
+                      <a data-toggle="collapse" href="#example48">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example47" class="manual-example collapse">
+                      <div id="example48" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'min'</td></tr>
@@ -3560,11 +3649,11 @@ produced by <code>group</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example48">
+                      <a data-toggle="collapse" href="#example49">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example48" class="manual-example collapse">
+                      <div id="example49" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'unique'</td></tr>
@@ -3623,11 +3712,11 @@ produced by <code>group</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example49">
+                      <a data-toggle="collapse" href="#example50">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example49" class="manual-example collapse">
+                      <div id="example50" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'reverse'</td></tr>
@@ -3665,11 +3754,11 @@ be contained in each other if they are equal.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example50">
+                      <a data-toggle="collapse" href="#example51">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example50" class="manual-example collapse">
+                      <div id="example51" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'contains(&#34;bar&#34;)'</td></tr>
@@ -3759,11 +3848,11 @@ in <code>.</code> match those of <code>s</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example51">
+                      <a data-toggle="collapse" href="#example52">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example51" class="manual-example collapse">
+                      <div id="example52" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'indices(&#34;, &#34;)'</td></tr>
@@ -3823,11 +3912,11 @@ occurrence of <code>s</code> in the input.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example52">
+                      <a data-toggle="collapse" href="#example53">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example52" class="manual-example collapse">
+                      <div id="example53" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'index(&#34;, &#34;)'</td></tr>
@@ -3844,6 +3933,34 @@ occurrence of <code>s</code> in the input.</p>
                           </table>
                         
                           <table>
+                            <tr><th></th><td class="jqprogram">jq 'index(1)'</td></tr>
+                            <tr><th>Input</th><td>[0,1,2,1,3,1,4]</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>1</td>
+                              </tr>
+                            
+                          </table>
+                        
+                          <table>
+                            <tr><th></th><td class="jqprogram">jq 'index([1,2])'</td></tr>
+                            <tr><th>Input</th><td>[0,1,2,3,1,4,2,5,1,2,6,7]</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>1</td>
+                              </tr>
+                            
+                          </table>
+                        
+                          <table>
                             <tr><th></th><td class="jqprogram">jq 'rindex(&#34;, &#34;)'</td></tr>
                             <tr><th>Input</th><td>&#34;a,b, cd, efg, hijk&#34;</td></tr>
                             
@@ -3857,6 +3974,34 @@ occurrence of <code>s</code> in the input.</p>
                             
                           </table>
                         
+                          <table>
+                            <tr><th></th><td class="jqprogram">jq 'rindex(1)'</td></tr>
+                            <tr><th>Input</th><td>[0,1,2,1,3,1,4]</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>5</td>
+                              </tr>
+                            
+                          </table>
+                        
+                          <table>
+                            <tr><th></th><td class="jqprogram">jq 'rindex([1,2])'</td></tr>
+                            <tr><th>Input</th><td>[0,1,2,3,1,4,2,5,1,2,6,7]</td></tr>
+                            
+                            
+                              <tr>
+                                
+                                  <th>Output</th>
+                                
+                                <td>8</td>
+                              </tr>
+                            
+                          </table>
+                        
                       </div>
                     </div>
                   
@@ -3874,11 +4019,11 @@ inversed version of <code>contains</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example53">
+                      <a data-toggle="collapse" href="#example54">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example53" class="manual-example collapse">
+                      <div id="example54" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'inside(&#34;foobar&#34;)'</td></tr>
@@ -3965,11 +4110,11 @@ inversed version of <code>contains</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example54">
+                      <a data-toggle="collapse" href="#example55">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example54" class="manual-example collapse">
+                      <div id="example55" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '[.[]|startswith(&#34;foo&#34;)]'</td></tr>
@@ -4000,11 +4145,11 @@ inversed version of <code>contains</code>.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example55">
+                      <a data-toggle="collapse" href="#example56">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example55" class="manual-example collapse">
+                      <div id="example56" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '[.[]|endswith(&#34;foo&#34;)]'</td></tr>
@@ -4037,11 +4182,11 @@ of <code>n</code> repetitions of the input array.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example56">
+                      <a data-toggle="collapse" href="#example57">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Examples
                       </a>
-                      <div id="example56" class="manual-example collapse">
+                      <div id="example57" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq 'combinations'</td></tr>
@@ -4129,11 +4274,11 @@ starts with it.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example57">
+                      <a data-toggle="collapse" href="#example58">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example57" class="manual-example collapse">
+                      <div id="example58" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '[.[]|ltrimstr(&#34;foo&#34;)]'</td></tr>
@@ -4165,11 +4310,11 @@ ends with it.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example58">
+                      <a data-toggle="collapse" href="#example59">
                         <i class="glyphicon glyphicon-chevron-right"></i>
                         Example
                       </a>
-                      <div id="example58" class="manual-example collapse">
+                      <div id="example59" class="manual-example collapse">
                         
                           <table>
                             <tr><th></th><td class="jqprogram">jq '[.[]|rtrimstr(&#34;foo&#34;)]'</td></tr>
@@ -4201,11 +4346,11 @@ codepoint numbers.</p>
                   
                     <div>
                       
-                      <a data-toggle="collapse" href="#example59">
+                      <a data-toggle="collapse" href="#example60">
                         <i class="glyph