docs: updates from Homebrew/brew

docs/Cask/Artifact/AbstractArtifact.html

@@ -618,7 +618,7 @@ <h3 class="signature first" id="dirmethod-class_method">
       <pre class="code"><span class="info file"># File 'cask/artifact/abstract_artifact.rb', line 30</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_dirmethod'>dirmethod</span>
-  <span class='ivar'>@dirmethod</span> <span class='op'>||=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dsl_key'>dsl_key</span><span class='embexpr_end'>}</span><span class='tstring_content'>dir</span><span class='tstring_end'>&quot;</span></span><span class='period'>.</span><span class='id identifier rubyid_to_sym'>to_sym</span>
+  <span class='ivar'>@dirmethod</span> <span class='op'>||=</span> <span class='symbol'>:&quot;#{</span><span class='id identifier rubyid_dsl_key'>dsl_key</span><span class='embexpr_end'>}</span><span class='tstring_content'>dir</span><span class='tstring_end'>&quot;</span></span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>

docs/Cask/Caskroom.html

@@ -559,7 +559,7 @@ <h3 class="signature " id="tokens-class_method">
       <pre class="code"><span class="info file"># File 'cask/caskroom.rb', line 27</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_tokens'>tokens</span>
-  <span class='id identifier rubyid_paths'>paths</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:basename</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:to_s</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_paths'>paths</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_path'>path</span><span class='op'>|</span> <span class='id identifier rubyid_path'>path</span><span class='period'>.</span><span class='id identifier rubyid_basename'>basename</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span> <span class='rbrace'>}</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>

docs/Cask/DSL/Version.html

@@ -167,7 +167,7 @@ <h2>
 
 </div>
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(</span><span class='embexpr_beg'>#{</span><span class='const'><span class='object_link'><a href="#DIVIDERS-constant" title="Cask::DSL::Version::DIVIDERS (constant)">DIVIDERS</a></span></span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='const'>Regexp</span><span class='period'>.</span><span class='id identifier rubyid_quote'>quote</span><span class='lparen'>(</span><span class='id identifier rubyid_v'>v</span><span class='rparen'>)</span> <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>|</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='embexpr_end'>}</span><span class='tstring_content'>)</span><span class='regexp_end'>/</span></span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(</span><span class='embexpr_beg'>#{</span><span class='const'><span class='object_link'><a href="#DIVIDERS-constant" title="Cask::DSL::Version::DIVIDERS (constant)">DIVIDERS</a></span></span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='const'>Regexp</span><span class='period'>.</span><span class='id identifier rubyid_quote'>quote</span><span class='lparen'>(</span><span class='id identifier rubyid_v'>v</span><span class='rparen'>)</span> <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</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><span class='embexpr_end'>}</span><span class='tstring_content'>)</span><span class='regexp_end'>/</span></span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
 
         <dt id="MAJOR_MINOR_PATCH_REGEX-constant" class="">MAJOR_MINOR_PATCH_REGEX =
           <div class="docstring">

docs/Commands.html

@@ -872,7 +872,7 @@ <h3 class="signature first" id="args_method_name-class_method">
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_args_method_name'>args_method_name</span><span class='lparen'>(</span><span class='id identifier rubyid_cmd_path'>cmd_path</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_cmd_path_basename'>cmd_path_basename</span> <span class='op'>=</span> <span class='id identifier rubyid_basename_without_extension'>basename_without_extension</span><span class='lparen'>(</span><span class='id identifier rubyid_cmd_path'>cmd_path</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_cmd_method_prefix'>cmd_method_prefix</span> <span class='op'>=</span> <span class='id identifier rubyid_method_name'>method_name</span><span class='lparen'>(</span><span class='id identifier rubyid_cmd_path_basename'>cmd_path_basename</span><span class='rparen'>)</span>
-  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd_method_prefix'>cmd_method_prefix</span><span class='embexpr_end'>}</span><span class='tstring_content'>_args</span><span class='tstring_end'>&quot;</span></span><span class='period'>.</span><span class='id identifier rubyid_to_sym'>to_sym</span>
+  <span class='symbol'>:&quot;#{</span><span class='id identifier rubyid_cmd_method_prefix'>cmd_method_prefix</span><span class='embexpr_end'>}</span><span class='tstring_content'>_args</span><span class='tstring_end'>&quot;</span></span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -999,12 +999,12 @@ <h3 class="signature " id="command_description-class_method">
     <span class='comment'># skip the comment&#39;s initial usage summary lines
 </span>    <span class='id identifier rubyid_comment_lines'>comment_lines</span><span class='period'>.</span><span class='id identifier rubyid_slice'>slice</span><span class='lparen'>(</span><span class='int'>2</span><span class='op'>..</span><span class='op'>-</span><span class='int'>1</span><span class='rparen'>)</span><span class='op'>&amp;.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_line'>line</span><span class='op'>|</span>
       <span class='id identifier rubyid_match_data'>match_data</span> <span class='op'>=</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^#:  (?&lt;desc&gt;\w.*+)$</span><span class='regexp_end'>/</span></span><span class='period'>.</span><span class='id identifier rubyid_match'>match</span><span class='lparen'>(</span><span class='id identifier rubyid_line'>line</span><span class='rparen'>)</span>
-      <span class='kw'>if</span> <span class='id identifier rubyid_match_data'>match_data</span>
-        <span class='id identifier rubyid_desc'>desc</span> <span class='op'>=</span> <span class='id identifier rubyid_match_data'>match_data</span><span class='lbracket'>[</span><span class='symbol'>:desc</span><span class='rbracket'>]</span>
-        <span class='kw'>return</span> <span class='const'>T</span><span class='period'>.</span><span class='id identifier rubyid_must'>must</span><span class='lparen'>(</span><span class='id identifier rubyid_desc'>desc</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="#DESCRIPTION_SPLITTING_PATTERN-constant" title="Commands::DESCRIPTION_SPLITTING_PATTERN (constant)">DESCRIPTION_SPLITTING_PATTERN</a></span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span> <span class='kw'>if</span> <span class='id identifier rubyid_short'>short</span>
+      <span class='kw'>next</span> <span class='kw'>unless</span> <span class='id identifier rubyid_match_data'>match_data</span>
 
-        <span class='kw'>return</span> <span class='id identifier rubyid_desc'>desc</span>
-      <span class='kw'>end</span>
+      <span class='id identifier rubyid_desc'>desc</span> <span class='op'>=</span> <span class='id identifier rubyid_match_data'>match_data</span><span class='lbracket'>[</span><span class='symbol'>:desc</span><span class='rbracket'>]</span>
+      <span class='kw'>return</span> <span class='const'>T</span><span class='period'>.</span><span class='id identifier rubyid_must'>must</span><span class='lparen'>(</span><span class='id identifier rubyid_desc'>desc</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="#DESCRIPTION_SPLITTING_PATTERN-constant" title="Commands::DESCRIPTION_SPLITTING_PATTERN (constant)">DESCRIPTION_SPLITTING_PATTERN</a></span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span> <span class='kw'>if</span> <span class='id identifier rubyid_short'>short</span>
+
+      <span class='kw'>return</span> <span class='id identifier rubyid_desc'>desc</span>
     <span class='kw'>end</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>

docs/Dependable.html

@@ -780,7 +780,7 @@ <h3 class="signature " id="prune_from_option?-instance_method">
       <pre class="code"><span class="info file"># File 'dependable.rb', line 48</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_prune_from_option?'>prune_from_option?</span><span class='lparen'>(</span><span class='id identifier rubyid_build'>build</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_optional?'>optional?</span> <span class='op'>&amp;&amp;</span> <span class='op'>!</span><span class='id identifier rubyid_recommended?'>recommended?</span>
+  <span class='kw'>return</span> <span class='kw'>false</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_optional?'>optional?</span> <span class='op'>&amp;&amp;</span> <span class='op'>!</span><span class='id identifier rubyid_recommended?'>recommended?</span>
 
   <span class='id identifier rubyid_build'>build</span><span class='period'>.</span><span class='id identifier rubyid_without?'>without?</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>