docs: updates from Homebrew/brew

docs/Homebrew/Manpages.html

@@ -430,7 +430,6 @@ <h3 class="signature first" id="build_man_page-class_method">
       <pre class="lines">
 
 
-50
 51
 52
 53
@@ -453,10 +452,11 @@ <h3 class="signature first" id="build_man_page-class_method">
 70
 71
 72
-73</pre>
+73
+74</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 50</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 51</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_build_man_page'>build_man_page</span><span class='lparen'>(</span><span class='label'>quiet:</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_template'>template</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../top-level-namespace.html#SOURCE_PATH-constant" title="SOURCE_PATH (constant)">SOURCE_PATH</a></span></span><span class='op'>/</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>brew.1.md.erb</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_read'>read</span>
@@ -517,7 +517,6 @@ <h3 class="signature " id="cmd_comment_manpage_lines-class_method">
       <pre class="lines">
 
 
-119
 120
 121
 122
@@ -542,10 +541,11 @@ <h3 class="signature " id="cmd_comment_manpage_lines-class_method">
 141
 142
 143
-144</pre>
+144
+145</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 119</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 120</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cmd_comment_manpage_lines'>cmd_comment_manpage_lines</span><span class='lparen'>(</span><span class='id identifier rubyid_cmd_path'>cmd_path</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_comment_lines'>comment_lines</span> <span class='op'>=</span> <span class='id identifier rubyid_cmd_path'>cmd_path</span><span class='period'>.</span><span class='id identifier rubyid_read'>read</span><span class='period'>.</span><span class='id identifier rubyid_lines'>lines</span><span class='period'>.</span><span class='id identifier rubyid_grep'>grep</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^#:</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span>
@@ -608,7 +608,6 @@ <h3 class="signature " id="cmd_parser_manpage_lines-class_method">
       <pre class="lines">
 
 
-102
 103
 104
 105
@@ -623,10 +622,11 @@ <h3 class="signature " id="cmd_parser_manpage_lines-class_method">
 114
 115
 116
-117</pre>
+117
+118</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 102</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 103</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cmd_parser_manpage_lines'>cmd_parser_manpage_lines</span><span class='lparen'>(</span><span class='id identifier rubyid_cmd_parser'>cmd_parser</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_lines'>lines</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='id identifier rubyid_format_usage_banner'>format_usage_banner</span><span class='lparen'>(</span><span class='id identifier rubyid_cmd_parser'>cmd_parser</span><span class='period'>.</span><span class='id identifier rubyid_usage_banner_text'>usage_banner_text</span><span class='rparen'>)</span><span class='rbracket'>]</span>
@@ -692,7 +692,6 @@ <h3 class="signature " id="env_vars_manpage-class_method">
       <pre class="lines">
 
 
-166
 167
 168
 169
@@ -702,10 +701,11 @@ <h3 class="signature " id="env_vars_manpage-class_method">
 173
 174
 175
-176</pre>
+176
+177</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 166</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 167</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_env_vars_manpage'>env_vars_manpage</span>
   <span class='id identifier rubyid_lines'>lines</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Homebrew.html" title="Homebrew (module)">Homebrew</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="EnvConfig.html" title="Homebrew::EnvConfig (module)">EnvConfig</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="EnvConfig.html#ENVS-constant" title="Homebrew::EnvConfig::ENVS (constant)">ENVS</a></span></span><span class='period'>.</span><span class='id identifier rubyid_flat_map'>flat_map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_env'>env</span><span class='comma'>,</span> <span class='id identifier rubyid_hash'>hash</span><span class='op'>|</span>
@@ -753,12 +753,12 @@ <h3 class="signature " id="format_opt-class_method">
       <pre class="lines">
 
 
-178
 179
-180</pre>
+180
+181</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 178</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 179</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_format_opt'>format_opt</span><span class='lparen'>(</span><span class='id identifier rubyid_opt'>opt</span><span class='rparen'>)</span>
   <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>`</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opt'>opt</span><span class='embexpr_end'>}</span><span class='tstring_content'>`</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_opt'>opt</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
@@ -798,13 +798,13 @@ <h3 class="signature " id="format_usage_banner-class_method">
       <pre class="lines">
 
 
-192
 193
 194
-195</pre>
+195
+196</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 192</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 193</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_format_usage_banner'>format_usage_banner</span><span class='lparen'>(</span><span class='id identifier rubyid_usage_banner'>usage_banner</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_usage_banner'>usage_banner</span><span class='op'>&amp;.</span><span class='id identifier rubyid_sub'>sub</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^(#: *\* )?</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>### </span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -845,7 +845,6 @@ <h3 class="signature " id="generate_cmd_manpages-class_method">
       <pre class="lines">
 
 
-80
 81
 82
 83
@@ -865,10 +864,11 @@ <h3 class="signature " id="generate_cmd_manpages-class_method">
 97
 98
 99
-100</pre>
+100
+101</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 80</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 81</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_generate_cmd_manpages'>generate_cmd_manpages</span><span class='lparen'>(</span><span class='id identifier rubyid_cmd_paths'>cmd_paths</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_man_page_lines'>man_page_lines</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -926,18 +926,18 @@ <h3 class="signature " id="generate_option_doc-class_method">
       <pre class="lines">
 
 
-182
 183
 184
 185
 186
 187
 188
 189
-190</pre>
+190
+191</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 182</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 183</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_generate_option_doc'>generate_option_doc</span><span class='lparen'>(</span><span class='id identifier rubyid_short'>short</span><span class='comma'>,</span> <span class='id identifier rubyid_long'>long</span><span class='comma'>,</span> <span class='id identifier rubyid_desc'>desc</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_comma'>comma</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='id identifier rubyid_short'>short</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_long'>long</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>, </span><span class='tstring_end'>&quot;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
@@ -996,17 +996,17 @@ <h3 class="signature " id="global_cask_options_manpage-class_method">
       <pre class="lines">
 
 
-147
 148
 149
 150
 151
 152
 153
-154</pre>
+154
+155</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 147</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 148</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_global_cask_options_manpage'>global_cask_options_manpage</span>
   <span class='id identifier rubyid_lines'>lines</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>These options are applicable to the `install`, `reinstall`, and `upgrade` </span><span class='tstring_end'>&quot;</span></span> \
@@ -1064,16 +1064,16 @@ <h3 class="signature " id="global_options_manpage-class_method">
       <pre class="lines">
 
 
-157
 158
 159
 160
 161
 162
-163</pre>
+163
+164</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 157</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 158</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_global_options_manpage'>global_options_manpage</span>
   <span class='id identifier rubyid_lines'>lines</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>These options are applicable across multiple subcommands.\n</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span>
@@ -1117,6 +1117,10 @@ <h3 class="signature " id="regenerate_man_pages-class_method">
       <pre class="lines">
 
 
+30
+31
+32
+33
 34
 35
 36
@@ -1131,14 +1135,20 @@ <h3 class="signature " id="regenerate_man_pages-class_method">
 45
 46
 47
-48</pre>
+48
+49</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 34</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 30</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_regenerate_man_pages'>regenerate_man_pages</span><span class='lparen'>(</span><span class='label'>quiet:</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="../Homebrew.html" title="Homebrew (module)">Homebrew</a></span></span><span class='period'>.</span><span class='id identifier rubyid_install_bundler_gems!'><span class='object_link'><a href="../Homebrew.html#install_bundler_gems!-class_method" title="Homebrew.install_bundler_gems! (method)">install_bundler_gems!</a></span></span><span class='lparen'>(</span><span class='label'>groups:</span> <span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>man</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span><span class='rparen'>)</span>
 
+  <span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>kramdown</span><span class='tstring_end'>&quot;</span></span>
+  <span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>manpages/parser/ronn</span><span class='tstring_end'>&quot;</span></span>
+  <span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>manpages/converter/kramdown</span><span class='tstring_end'>&quot;</span></span>
+  <span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>manpages/converter/roff</span><span class='tstring_end'>&quot;</span></span>
+
   <span class='id identifier rubyid_markup'>markup</span> <span class='op'>=</span> <span class='id identifier rubyid_build_man_page'>build_man_page</span><span class='lparen'>(</span><span class='label'>quiet:</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_root'><span class='object_link'><a href="../top-level-namespace.html" title="Top Level Namespace (root)">root</a></span></span><span class='comma'>,</span> <span class='id identifier rubyid_warnings'>warnings</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Manpages/Parser.html" title="Homebrew::Manpages::Parser (module)">Parser</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Manpages/Parser/Ronn.html" title="Homebrew::Manpages::Parser::Ronn (class)">Ronn</a></span></span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_markup'>markup</span><span class='rparen'>)</span>
   <span class='gvar'>$stderr</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span><span class='lparen'>(</span><span class='id identifier rubyid_warnings'>warnings</span><span class='rparen'>)</span>
@@ -1186,13 +1196,13 @@ <h3 class="signature " id="sort_key_for_path-class_method">
       <pre class="lines">
 
 
-75
 76
 77
-78</pre>
+78
+79</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'manpages.rb', line 75</span>
+      <pre class="code"><span class="info file"># File 'manpages.rb', line 76</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_sort_key_for_path'>sort_key_for_path</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span>
   <span class='comment'># Options after regular commands (`~` comes after `z` in ASCII table).