From 7a8e1ec63053d8c78e6b4915a4267a15ab6efc4e Mon Sep 17 00:00:00 2001 From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com> Date: Sun, 5 Nov 2023 20:33:55 +0000 Subject: [PATCH] docs: updates from Homebrew/brew --- docs/AbstractCoreTap.html | 24 ++-- docs/CoreCaskTap.html | 40 +++--- docs/CoreTap.html | 32 ++--- docs/Tap.html | 254 +++++++++++++++++++------------------- docs/TapConfig.html | 40 +++--- 5 files changed, 197 insertions(+), 193 deletions(-) diff --git a/docs/AbstractCoreTap.html b/docs/AbstractCoreTap.html index e608fc733..8ba078be8 100644 --- a/docs/AbstractCoreTap.html +++ b/docs/AbstractCoreTap.html @@ -284,12 +284,12 @@ 

 
 
-944
-945
-946
+946 +947 +948 - 
# File 'tap.rb', line 944
+      
# File 'tap.rb', line 946
 
 def self.ensure_installed!
   instance.ensure_installed!
@@ -337,12 +337,12 @@ 

       
 
 
-931
-932
-933

+933
+934
+935

     
     
-      
# File 'tap.rb', line 931
+      
# File 'tap.rb', line 933
 
 def self.instance
   @instance ||= T.unsafe(self).new
@@ -383,15 +383,15 @@ 

       
 
 
-936
-937
 938
 939
 940
-941

+941
+942
+943

     
     
-      
# File 'tap.rb', line 936
+      
# File 'tap.rb', line 938
 
 def ensure_installed!
   return unless Homebrew::EnvConfig.no_install_from_api?
diff --git a/docs/CoreCaskTap.html b/docs/CoreCaskTap.html
index 685728295..c49115f1c 100644
--- a/docs/CoreCaskTap.html
+++ b/docs/CoreCaskTap.html
@@ -344,14 +344,14 @@ 

       
 
 
-1170
-1171
 1172
 1173
-1174

+1174
+1175
+1176

     
     
-      
# File 'tap.rb', line 1170
+      
# File 'tap.rb', line 1172
 
 def cask_files
   return super if Homebrew::EnvConfig.no_install_from_api? || installed?
@@ -401,16 +401,16 @@ 

       
 
 
-1198
-1199
 1200
 1201
 1202
 1203
-1204

+1204
+1205
+1206

     
     
-      
# File 'tap.rb', line 1198
+      
# File 'tap.rb', line 1200
 
 def cask_renames
   @cask_renames ||= if Homebrew::EnvConfig.no_install_from_api?
@@ -462,14 +462,14 @@ 

       
 
 
-1177
-1178
 1179
 1180
-1181

+1181
+1182
+1183

     
     
-      
# File 'tap.rb', line 1177
+      
# File 'tap.rb', line 1179
 
 def cask_tokens
   return super if Homebrew::EnvConfig.no_install_from_api?
@@ -534,13 +534,13 @@ 

       
 
 
-1164
-1165
 1166
-1167

+1167
+1168
+1169

     
     
-      
# File 'tap.rb', line 1164
+      
# File 'tap.rb', line 1166
 
 def new_cask_path(token)
   cask_subdir = token[0].to_s
@@ -589,18 +589,18 @@ 

       
 
 
-1207
-1208
 1209
 1210
 1211
 1212
 1213
 1214
-1215

+1215
+1216
+1217

     
     
-      
# File 'tap.rb', line 1207
+      
# File 'tap.rb', line 1209
 
 def tap_migrations
   @tap_migrations ||= if Homebrew::EnvConfig.no_install_from_api?
diff --git a/docs/CoreTap.html b/docs/CoreTap.html
index 00889edd0..b26b1b596 100644
--- a/docs/CoreTap.html
+++ b/docs/CoreTap.html
@@ -296,14 +296,14 @@ 

       
 
 
-966
-967
 968
 969
-970

+970
+971
+972

     
     
-      
# File 'tap.rb', line 966
+      
# File 'tap.rb', line 968
 
 def ensure_installed!
   return if ENV["HOMEBREW_TESTS"]
@@ -353,8 +353,6 @@ 

       
 
 
-980
-981
 982
 983
 984
@@ -367,10 +365,12 @@ 

 991
 992
 993
-994

+994
+995
+996

     
     
-      
# File 'tap.rb', line 980
+      
# File 'tap.rb', line 982
 
 def install(quiet: false, clone_target: nil, force_auto_update: nil,
             custom_remote: false, verify: false, force: false)
@@ -445,8 +445,6 @@ 

       
 
 
-1026
-1027
 1028
 1029
 1030
@@ -455,10 +453,12 @@ 

 1033
 1034
 1035
-1036

+1036
+1037
+1038

     
     
-      
# File 'tap.rb', line 1026
+      
# File 'tap.rb', line 1028
 
 def new_formula_path(name)
   formula_subdir = if name.start_with?("lib")
@@ -514,14 +514,14 @@ 

       
 
 
-973
-974
 975
 976
-977

+977
+978
+979

     
     
-      
# File 'tap.rb', line 973
+      
# File 'tap.rb', line 975
 
 def remote
   super if Homebrew::EnvConfig.no_install_from_api?
diff --git a/docs/Tap.html b/docs/Tap.html
index c49f50f38..6ca9b287b 100644
--- a/docs/Tap.html
+++ b/docs/Tap.html
@@ -1962,15 +1962,15 @@ 

       
 
 
-591
-592
 593
 594
 595
-596

+596
+597
+598

     
     
-      
# File 'tap.rb', line 591
+      
# File 'tap.rb', line 593
 
 def self.cask_files_by_name(tap)
   cache_key = "cask_files_by_name_#{tap}"
@@ -2021,12 +2021,12 @@ 

       
 
 
-838
-839
-840

+840
+841
+842

     
     
-      
# File 'tap.rb', line 838
+      
# File 'tap.rb', line 840
 
 def self.cmd_directories
   Pathname.glob TAP_DIRECTORY/"*/*/cmd"
@@ -2108,8 +2108,6 @@ 

       
 
 
-818
-819
 820
 821
 822
@@ -2118,10 +2116,12 @@ 

 825
 826
 827
-828

+828
+829
+830

     
     
-      
# File 'tap.rb', line 818
+      
# File 'tap.rb', line 820
 
 def self.each(&block)
   return unless TAP_DIRECTORY.directory?
@@ -2258,15 +2258,15 @@ 

       
 
 
-561
-562
 563
 564
 565
-566

+566
+567
+568

     
     
-      
# File 'tap.rb', line 561
+      
# File 'tap.rb', line 563
 
 def self.formula_files_by_name(tap)
   cache_key = "formula_files_by_name_#{tap}"
@@ -2441,12 +2441,12 @@ 

       
 
 
-832
-833
-834

+834
+835
+836

     
     
-      
# File 'tap.rb', line 832
+      
# File 'tap.rb', line 834
 
 def self.names
   map(&:name).sort
@@ -2494,12 +2494,12 @@ 

       
 
 
-844
-845
-846

+846
+847
+848

     
     
-      
# File 'tap.rb', line 844
+      
# File 'tap.rb', line 846
 
 def self.untapped_official_taps
   Homebrew::Settings.read(:untapped)&.split(";") || []
@@ -2568,13 +2568,13 @@ 

       
 
 
-813
-814
 815
-816

+816
+817
+818

     
     
-      
# File 'tap.rb', line 813
+      
# File 'tap.rb', line 815
 
 def ==(other)
   other = Tap.fetch(other) if other.is_a?(String)
@@ -2600,8 +2600,6 @@ 

       
 
 
-860
-861
 862
 863
 864
@@ -2615,10 +2613,12 @@ 

 872
 873
 874
-875

+875
+876
+877

     
     
-      
# File 'tap.rb', line 860
+      
# File 'tap.rb', line 862
 
 def audit_exception(list, formula_or_cask, value = nil)
   return false if audit_exceptions.blank?
@@ -2679,12 +2679,12 @@ 

       
 
 
-791
-792
-793

+793
+794
+795

     
     
-      
# File 'tap.rb', line 791
+      
# File 'tap.rb', line 793
 
 def audit_exceptions
   @audit_exceptions = read_formula_list_directory "#{HOMEBREW_TAP_AUDIT_EXCEPTIONS_DIR}/*"
@@ -2732,12 +2732,12 @@ 

       
 
 
-510
-511
-512

+512
+513
+514

     
     
-      
# File 'tap.rb', line 510
+      
# File 'tap.rb', line 512
 
 def cask_dir
   @cask_dir ||= path/"Casks"
@@ -2785,16 +2785,16 @@ 

       
 
 
-581
-582
 583
 584
 585
 586
-587

+587
+588
+589

     
     
-      
# File 'tap.rb', line 581
+      
# File 'tap.rb', line 583
 
 def cask_files
   @cask_files ||= if cask_dir.directory?
@@ -2846,16 +2846,16 @@ 

       
 
 
-752
-753
 754
 755
 756
 757
-758

+758
+759
+760

     
     
-      
# File 'tap.rb', line 752
+      
# File 'tap.rb', line 754
 
 def cask_renames
   @cask_renames ||= if (rename_file = path/HOMEBREW_TAP_CASK_RENAMES_FILE).file?
@@ -2907,12 +2907,12 @@ 

       
 
 
-660
-661
-662

+662
+663
+664

     
     
-      
# File 'tap.rb', line 660
+      
# File 'tap.rb', line 662
 
 def cask_tokens
   @cask_tokens ||= cask_files.map(&method(:formula_file_to_name))
@@ -3040,12 +3040,12 @@ 

       
 
 
-711
-712
-713

+713
+714
+715

     
     
-      
# File 'tap.rb', line 711
+      
# File 'tap.rb', line 713
 
 def command_dir
   @command_dir ||= path/"cmd"
@@ -3093,16 +3093,16 @@ 

       
 
 
-717
-718
 719
 720
 721
 722
-723

+723
+724
+725

     
     
-      
# File 'tap.rb', line 717
+      
# File 'tap.rb', line 719
 
 def command_files
   @command_files ||= if command_dir.directory?
@@ -3179,8 +3179,6 @@ 

       
 
 
-525
-526
 527
 528
 529
@@ -3195,10 +3193,12 @@ 

 538
 539
 540
-541

+541
+542
+543

     
     
-      
# File 'tap.rb', line 525
+      
# File 'tap.rb', line 527
 
 def contents
   contents = []
@@ -3260,14 +3260,14 @@ 

       
 
 
-481
-482
 483
 484
-485

+485
+486
+487

     
     
-      
# File 'tap.rb', line 481
+      
# File 'tap.rb', line 483
 
 def custom_remote?
   return true unless remote
@@ -3419,7 +3419,9 @@ 

 439
 440
 441
-442

+442
+443
+444

     
     
       
# File 'tap.rb', line 414
@@ -3440,12 +3442,14 @@ 

   args = %w[fetch]
   args << "--quiet" if quiet
   args << "origin"
+  args << "+refs/heads/*:refs/remotes/origin/*"
   safe_system "git", "-C", path, *args
   git_repo.set_head_origin_auto
 
   new_upstream_head = T.must(git_repo.origin_branch_name)
   return if new_upstream_head == current_upstream_head
 
+  safe_system "git", "-C", path, "config", "remote.origin.fetch", "+refs/heads/*:refs/remotes/origin/*"
   git_repo.rename_branch old: current_upstream_head, new: new_upstream_head
   git_repo.set_upstream_branch local: new_upstream_head, origin: new_upstream_head
 
@@ -3496,17 +3500,17 @@ 

       
 
 
-489
-490
 491
 492
 493
 494
 495
-496

+496
+497
+498

     
     
-      
# File 'tap.rb', line 489
+      
# File 'tap.rb', line 491
 
 def formula_dir
   # Official formulae taps always use this directory, saves time to hardcode.
@@ -3559,8 +3563,6 @@ 

       
 
 
-545
-546
 547
 548
 549
@@ -3571,10 +3573,12 @@ 

 554
 555
 556
-557

+557
+558
+559

     
     
-      
# File 'tap.rb', line 545
+      
# File 'tap.rb', line 547
 
 def formula_files
   @formula_files ||= if formula_dir.directory?
@@ -3632,12 +3636,12 @@ 

       
 
 
-643
-644
-645

+645
+646
+647

     
     
-      
# File 'tap.rb', line 643
+      
# File 'tap.rb', line 645
 
 def formula_names
   @formula_names ||= formula_files.map(&method(:formula_file_to_name))
@@ -3685,15 +3689,15 @@ 

       
 
 
-772
-773
 774
 775
 776
-777

+777
+778
+779

     
     
-      
# File 'tap.rb', line 772
+      
# File 'tap.rb', line 774
 
 def formula_oldnames
   @formula_oldnames ||= formula_renames.each_with_object({}) do |(old_name, new_name), hash|
@@ -3744,16 +3748,16 @@ 

       
 
 
-762
-763
 764
 765
 766
 767
-768

+768
+769
+770

     
     
-      
# File 'tap.rb', line 762
+      
# File 'tap.rb', line 764
 
 def formula_renames
   @formula_renames ||= if (rename_file = path/HOMEBREW_TAP_FORMULA_RENAMES_FILE).file?
@@ -4605,12 +4609,12 @@ 

       
 
 
-515
-516
-517

+517
+518
+519

     
     
-      
# File 'tap.rb', line 515
+      
# File 'tap.rb', line 517
 
 def new_cask_path(token)
   cask_dir/"#{token.downcase}.rb"
@@ -4673,12 +4677,12 @@ 

       
 
 
-504
-505
-506

+506
+507
+508

     
     
-      
# File 'tap.rb', line 504
+      
# File 'tap.rb', line 506
 
 def new_formula_path(name)
   formula_dir/"#{name.downcase}.rb"
@@ -4779,12 +4783,12 @@ 

       
 
 
-499
-500
-501

+501
+502
+503

     
     
-      
# File 'tap.rb', line 499
+      
# File 'tap.rb', line 501
 
 def potential_formula_dirs
   @potential_formula_dirs ||= [path/"Formula", path/"HomebrewFormula", path].freeze
@@ -4876,12 +4880,12 @@ 

       
 
 
-802
-803
-804

+804
+805
+806

     
     
-      
# File 'tap.rb', line 802
+      
# File 'tap.rb', line 804
 
 def pypi_formula_mappings
   @pypi_formula_mappings = read_formula_list path/HOMEBREW_TAP_PYPI_FORMULA_MAPPINGS
@@ -4944,13 +4948,13 @@ 

       
 
 
-520
-521
 522
-523

+523
+524
+525

     
     
-      
# File 'tap.rb', line 520
+      
# File 'tap.rb', line 522
 
 def relative_cask_path(token)
   new_cask_path(token).to_s
@@ -5182,12 +5186,12 @@ 

       
 
 
-797
-798
-799

+799
+800
+801

     
     
-      
# File 'tap.rb', line 797
+      
# File 'tap.rb', line 799
 
 def style_exceptions
   @style_exceptions = read_formula_list_directory "#{HOMEBREW_TAP_STYLE_EXCEPTIONS_DIR}/*"
@@ -5235,16 +5239,16 @@ 

       
 
 
-781
-782
 783
 784
 785
 786
-787

+787
+788
+789

     
     
-      
# File 'tap.rb', line 781
+      
# File 'tap.rb', line 783
 
 def tap_migrations
   @tap_migrations ||= if (migration_file = path/HOMEBREW_TAP_MIGRATIONS_FILE).file?
@@ -5296,8 +5300,6 @@ 

       
 
 
-726
-727
 728
 729
 730
@@ -5318,10 +5320,12 @@ 

 745
 746
 747
-748

+748
+749
+750

     
     
-      
# File 'tap.rb', line 726
+      
# File 'tap.rb', line 728
 
 def to_hash
   hash = {
@@ -5419,8 +5423,6 @@ 

       
 
 
-445
-446
 447
 448
 449
@@ -5452,10 +5454,12 @@ 

 475
 476
 477
-478

+478
+479
+480

     
     
-      
# File 'tap.rb', line 445
+      
# File 'tap.rb', line 447
 
 def uninstall(manual: false)
   require "descriptions"
diff --git a/docs/TapConfig.html b/docs/TapConfig.html
index fd874c314..a4fd0d4b1 100644
--- a/docs/TapConfig.html
+++ b/docs/TapConfig.html
@@ -292,12 +292,12 @@ 

       
 
 
-1223
-1224
-1225

+1225
+1226
+1227

     
     
-      
# File 'tap.rb', line 1223
+      
# File 'tap.rb', line 1225
 
 def initialize(tap)
   @tap = tap
@@ -339,12 +339,12 @@ 

       
 
 
-1220
-1221
-1222

+1222
+1223
+1224

     
     
-      
# File 'tap.rb', line 1220
+      
# File 'tap.rb', line 1222
 
 def tap
   @tap
@@ -376,15 +376,15 @@ 

       
 
 
-1227
-1228
 1229
 1230
 1231
-1232

+1232
+1233
+1234

     
     
-      
# File 'tap.rb', line 1227
+      
# File 'tap.rb', line 1229
 
 def [](key)
   return unless tap.git?
@@ -412,15 +412,15 @@ 

       
 
 
-1234
-1235
 1236
 1237
 1238
-1239

+1239
+1240
+1241

     
     
-      
# File 'tap.rb', line 1234
+      
# File 'tap.rb', line 1236
 
 def []=(key, value)
   return unless tap.git?
@@ -448,15 +448,15 @@ 

       
 
 
-1241
-1242
 1243
 1244
 1245
-1246

+1246
+1247
+1248

     
     
-      
# File 'tap.rb', line 1241
+      
# File 'tap.rb', line 1243
 
 def delete(key)
   return unless tap.git?