docs: updates from Homebrew/brew

Homebrew · Mar 7, 2024 · ecf096e · ecf096e
1 parent 4f75ba3
commit ecf096e
Show file tree

Hide file tree

Showing 23 changed files with 1,418 additions and 1,574 deletions.
diff --git a/docs/AbstractCoreTap.html b/docs/AbstractCoreTap.html
diff --git a/docs/Cask/CaskLoader.html b/docs/Cask/CaskLoader.html
@@ -313,12 +313,12 @@ <h3 class="signature first" id="default_path-class_method">
       <pre class="lines">
 
 
-586
-587
-588</pre>
+592
+593
+594</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 586</span>
+      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 592</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_default_path'>default_path</span><span class='lparen'>(</span><span class='id identifier rubyid_token'>token</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_find_cask_in_tap'>find_cask_in_tap</span><span class='lparen'>(</span><span class='id identifier rubyid_token'>token</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_downcase'>downcase</span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="../CoreCaskTap.html" title="CoreCaskTap (class)">CoreCaskTap</a></span></span><span class='period'>.</span><span class='id identifier rubyid_instance'><span class='object_link'><a href="../AbstractCoreTap.html#instance-class_method" title="AbstractCoreTap.instance (method)">instance</a></span></span><span class='rparen'>)</span>
@@ -358,14 +358,14 @@ <h3 class="signature " id="find_cask_in_tap-class_method">
       <pre class="lines">
 
 
-590
-591
-592
-593
-594</pre>
+596
+597
+598
+599
+600</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 590</span>
+      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 596</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_find_cask_in_tap'>find_cask_in_tap</span><span class='lparen'>(</span><span class='id identifier rubyid_token'>token</span><span class='comma'>,</span> <span class='id identifier rubyid_tap'>tap</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_filename'>filename</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_token'>token</span><span class='embexpr_end'>}</span><span class='tstring_content'>.rb</span><span class='tstring_end'>&quot;</span></span>
@@ -407,13 +407,6 @@ <h3 class="signature " id="for-class_method">
       <pre class="lines">
 
 
-566
-567
-568
-569
-570
-571
-572
 573
 574
 575
@@ -425,10 +418,16 @@ <h3 class="signature " id="for-class_method">
 581
 582
 583
-584</pre>
+584
+585
+586
+587
+588
+589
+590</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 566</span>
+      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 573</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='kw'>for</span><span class='lparen'>(</span><span class='id identifier rubyid_ref'>ref</span><span class='comma'>,</span> <span class='label'>need_path:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='kw'>true</span><span class='rparen'>)</span>
   <span class='lbracket'>[</span>
@@ -437,7 +436,6 @@ <h3 class="signature " id="for-class_method">
     <span class='const'><span class='object_link'><a href="CaskLoader/FromURILoader.html" title="Cask::CaskLoader::FromURILoader (class)">FromURILoader</a></span></span><span class='comma'>,</span>
     <span class='const'><span class='object_link'><a href="CaskLoader/FromAPILoader.html" title="Cask::CaskLoader::FromAPILoader (class)">FromAPILoader</a></span></span><span class='comma'>,</span>
     <span class='const'><span class='object_link'><a href="CaskLoader/FromTapLoader.html" title="Cask::CaskLoader::FromTapLoader (class)">FromTapLoader</a></span></span><span class='comma'>,</span>
-    <span class='const'><span class='object_link'><a href="CaskLoader/FromDefaultNameLoader.html" title="Cask::CaskLoader::FromDefaultNameLoader (class)">FromDefaultNameLoader</a></span></span><span class='comma'>,</span>
     <span class='const'><span class='object_link'><a href="CaskLoader/FromNameLoader.html" title="Cask::CaskLoader::FromNameLoader (class)">FromNameLoader</a></span></span><span class='comma'>,</span>
     <span class='const'><span class='object_link'><a href="CaskLoader/FromPathLoader.html" title="Cask::CaskLoader::FromPathLoader (class)">FromPathLoader</a></span></span><span class='comma'>,</span>
     <span class='const'><span class='object_link'><a href="CaskLoader/FromInstalledPathLoader.html" title="Cask::CaskLoader::FromInstalledPathLoader (class)">FromInstalledPathLoader</a></span></span><span class='comma'>,</span>
@@ -484,12 +482,12 @@ <h3 class="signature " id="load-class_method">
       <pre class="lines">
 
 
-527
-528
-529</pre>
+534
+535
+536</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 527</span>
+      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 534</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_load'>load</span><span class='lparen'>(</span><span class='id identifier rubyid_ref'>ref</span><span class='comma'>,</span> <span class='label'>config:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='kw'>true</span><span class='rparen'>)</span>
   <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_for'>for</span><span class='lparen'>(</span><span class='id identifier rubyid_ref'>ref</span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='id identifier rubyid_warn'>warn</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_load'>load</span><span class='lparen'>(</span><span class='label'>config:</span> <span class='id identifier rubyid_config'>config</span><span class='rparen'>)</span>
@@ -529,12 +527,12 @@ <h3 class="signature " id="path-class_method">
       <pre class="lines">
 
 
-523
-524
-525</pre>
+530
+531
+532</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 523</span>
+      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 530</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_path'>path</span><span class='lparen'>(</span><span class='id identifier rubyid_ref'>ref</span><span class='rparen'>)</span>
   <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_for'>for</span><span class='lparen'>(</span><span class='id identifier rubyid_ref'>ref</span><span class='comma'>,</span> <span class='label'>need_path:</span> <span class='kw'>true</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_path'>path</span>
@@ -613,13 +611,6 @@ <h3 class="signature " id="tap_cask_token_type-class_method">
       <pre class="lines">
 
 
-532
-533
-534
-535
-536
-537
-538
 539
 540
 541
@@ -645,10 +636,17 @@ <h3 class="signature " id="tap_cask_token_type-class_method">
 561
 562
 563
-564</pre>
+564
+565
+566
+567
+568
+569
+570
+571</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 532</span>
+      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 539</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_tap_cask_token_type'>tap_cask_token_type</span><span class='lparen'>(</span><span class='id identifier rubyid_tapped_token'>tapped_token</span><span class='comma'>,</span> <span class='label'>warn:</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='lparen'>(</span><span class='id identifier rubyid_tap_with_token'>tap_with_token</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Tap.html" title="Tap (class)">Tap</a></span></span><span class='period'>.</span><span class='id identifier rubyid_with_cask_token'>with_cask_token</span><span class='lparen'>(</span><span class='id identifier rubyid_tapped_token'>tapped_token</span><span class='rparen'>)</span><span class='rparen'>)</span>

diff --git a/docs/Cask/CaskLoader/FromInstalledPathLoader.html b/docs/Cask/CaskLoader/FromInstalledPathLoader.html
@@ -281,17 +281,17 @@ <h3 class="signature first" id="try_new-class_method">
       <pre class="lines">
 
 
-489
-490
-491
-492
-493
-494
-495
-496</pre>
+496
+497
+498
+499
+500
+501
+502
+503</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 489</span>
+      <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 496</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_try_new'>try_new</span><span class='lparen'>(</span><span class='id identifier rubyid_ref'>ref</span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='kw'>false</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_ref'>ref</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../../String.html" title="String (class)">String</a></span></span><span class='rparen'>)</span>

diff --git a/docs/Cask/CaskLoader/FromNameLoader.html b/docs/Cask/CaskLoader/FromNameLoader.html
@@ -315,19 +315,33 @@ <h3 class="signature first" id="try_new-class_method">
 477
 478
 479
-480</pre>
+480
+481
+482
+483
+484
+485
+486
+487</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'cask/cask_loader.rb', line 465</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_try_new'>try_new</span><span class='lparen'>(</span><span class='id identifier rubyid_ref'>ref</span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='kw'>false</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_ref'>ref</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../../String.html" title="String (class)">String</a></span></span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='kw'>if</span> <span class='id identifier rubyid_ref'>ref</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</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='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_ref'>ref</span><span class='period'>.</span><span class='id identifier rubyid_match?'>match?</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\A</span><span class='embexpr_beg'>#{</span><span class='const'><span class='object_link'><a href="../../top-level-namespace.html#HOMEBREW_TAP_CASK_TOKEN_REGEX-constant" title="HOMEBREW_TAP_CASK_TOKEN_REGEX (constant)">HOMEBREW_TAP_CASK_TOKEN_REGEX</a></span></span><span class='embexpr_end'>}</span><span class='tstring_content'>\Z</span><span class='regexp_end'>/o</span></span><span class='rparen'>)</span>
 
   <span class='id identifier rubyid_token'>token</span> <span class='op'>=</span> <span class='id identifier rubyid_ref'>ref</span>
 
-  <span class='id identifier rubyid_loaders'>loaders</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../../Tap.html" title="Tap (class)">Tap</a></span></span><span class='period'>.</span><span class='id identifier rubyid_filter_map'>filter_map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_tap'>tap</span><span class='op'>|</span> <span class='kw'>super</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_tap'>tap</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_token'>token</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='id identifier rubyid_warn'>warn</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
-               <span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='lbrace'>{</span> <span class='id identifier rubyid__1'>_1</span><span class='period'>.</span><span class='id identifier rubyid_path'>path</span><span class='period'>.</span><span class='id identifier rubyid_exist?'>exist?</span> <span class='rbrace'>}</span>
+  <span class='comment'># If it exists in the default tap, never treat it as ambiguous with another tap.
+</span>  <span class='kw'>if</span> <span class='lparen'>(</span><span class='id identifier rubyid_core_cask_tap'>core_cask_tap</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../../CoreCaskTap.html" title="CoreCaskTap (class)">CoreCaskTap</a></span></span><span class='period'>.</span><span class='id identifier rubyid_instance'><span class='object_link'><a href="../../AbstractCoreTap.html#instance-class_method" title="AbstractCoreTap.instance (method)">instance</a></span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_installed?'>installed?</span> <span class='op'>&amp;&amp;</span>
+     <span class='lparen'>(</span><span class='id identifier rubyid_loader'>loader</span><span class='op'>=</span> <span class='kw'>super</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_core_cask_tap'>core_cask_tap</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_token'>token</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='id identifier rubyid_warn'>warn</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='op'>&amp;.</span><span class='id identifier rubyid_path'>path</span><span class='op'>&amp;.</span><span class='id identifier rubyid_exist?'>exist?</span>
+    <span class='kw'>return</span> <span class='id identifier rubyid_loader'>loader</span>
+  <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_loaders'>loaders</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../../Tap.html" title="Tap (class)">Tap</a></span></span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_tap'>tap</span><span class='op'>|</span> <span class='id identifier rubyid_tap'>tap</span><span class='period'>.</span><span class='id identifier rubyid_installed?'>installed?</span> <span class='op'>&amp;&amp;</span> <span class='op'>!</span><span class='id identifier rubyid_tap'>tap</span><span class='period'>.</span><span class='id identifier rubyid_core_cask_tap?'>core_cask_tap?</span> <span class='rbrace'>}</span>
+               <span class='period'>.</span><span class='id identifier rubyid_filter_map'>filter_map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_tap'>tap</span><span class='op'>|</span> <span class='kw'>super</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_tap'>tap</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_token'>token</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>warn:</span> <span class='id identifier rubyid_warn'>warn</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
+               <span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_tap'>tap</span><span class='op'>|</span> <span class='id identifier rubyid_tap'>tap</span><span class='period'>.</span><span class='id identifier rubyid_path'>path</span><span class='period'>.</span><span class='id identifier rubyid_exist?'>exist?</span> <span class='rbrace'>}</span>
 
   <span class='kw'>case</span> <span class='id identifier rubyid_loaders'>loaders</span><span class='period'>.</span><span class='id identifier rubyid_count'>count</span>
   <span class='kw'>when</span> <span class='int'>1</span>