From ab27f88f1bce9de4f8404b6246fa617e386b5466 Mon Sep 17 00:00:00 2001 From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com> Date: Fri, 19 Apr 2024 08:33:38 +0000 Subject: [PATCH] docs: updates from Homebrew/brew --- docs/Kernel.html | 76 ++++++++++++++++++++++++++---------------------- 1 file changed, 41 insertions(+), 35 deletions(-) diff --git a/docs/Kernel.html b/docs/Kernel.html index 8732618f7..025bf5ad2 100644 --- a/docs/Kernel.html +++ b/docs/Kernel.html @@ -953,9 +953,6 @@ 

 
 
-415
-416
-417
 418
 419
 420
@@ -974,10 +971,13 @@ 

 433
 434
 435
-436
+436 +437 +438 +439 - 
# File 'extend/kernel.rb', line 415
+      
# File 'extend/kernel.rb', line 418
 
 def disk_usage_readable(size_in_bytes)
   if size_in_bytes >= 1_073_741_824
@@ -1042,7 +1042,10 @@ 

 406
 407
 408
-409

+409
+410
+411
+412
# File 'extend/kernel.rb', line 398
@@ -1053,6 +1056,9 @@ 

   executable = [
     which(name),
     which(name, ORIGINAL_PATHS),
+    # We prefer the opt_bin path to a formula's executable over the prefix
+    # path where available, since the former is stable during upgrades.
+    HOMEBREW_PREFIX/"opt/#{formula_name}/bin/#{name}",
     HOMEBREW_PREFIX/"bin/#{name}",
   ].compact.first
   return executable if executable.exist?
@@ -1400,14 +1406,14 @@ 

       
 
 
-438
-439
-440
 441
-442

+442
+443
+444
+445
- 
# File 'extend/kernel.rb', line 438
+      
# File 'extend/kernel.rb', line 441
 
 def number_readable(number)
   numstr = number.to_i.to_s
@@ -2026,12 +2032,12 @@ 

       
 
 
-411
-412
-413

+414
+415
+416

     
     
-      
# File 'extend/kernel.rb', line 411
+      
# File 'extend/kernel.rb', line 414
 
 def paths
   @paths ||= ORIGINAL_PATHS.uniq.map(&:to_s)
@@ -2288,14 +2294,14 @@ 

       
 
 
-513
-514
-515
 516
-517

+517
+518
+519
+520

     
     
-      
# File 'extend/kernel.rb', line 513
+      
# File 'extend/kernel.rb', line 516
 
 def redact_secrets(input, secrets)
   secrets.compact
@@ -2484,9 +2490,6 @@ 

       
 
 
-501
-502
-503
 504
 505
 506
@@ -2494,10 +2497,13 @@ 

 508
 509
 510
-511

+511
+512
+513
+514

     
     
-      
# File 'extend/kernel.rb', line 501
+      
# File 'extend/kernel.rb', line 504
 
 def tap_and_name_comparison
   proc do |a, b|
@@ -2543,9 +2549,6 @@ 

       
 
 
-448
-449
-450
 451
 452
 453
@@ -2569,10 +2572,13 @@ 

 471
 472
 473
-474

+474
+475
+476
+477

     
     
-      
# File 'extend/kernel.rb', line 448
+      
# File 'extend/kernel.rb', line 451
 
 def truncate_text_to_approximate_size(str, max_bytes, options = {})
   front_weight = options.fetch(:front_weight, 0.5)
@@ -2836,9 +2842,6 @@ 

       
 
 
-486
-487
-488
 489
 490
 491
@@ -2849,10 +2852,13 @@ 

 496
 497
 498
-499

+499
+500
+501
+502

     
     
-      
# File 'extend/kernel.rb', line 486
+      
# File 'extend/kernel.rb', line 489
 
 def with_env(hash)
   old_values = {}