Merge pull request #19748 from Homebrew/oclp-support

docs: clarify OCLP support status

Author: MikeMcQuaid

Library/Homebrew/extend/os/mac/diagnostic.rb

@@ -145,11 +145,13 @@ def check_for_opencore
             return
           end
 
+          oclp_support_tier = Hardware::CPU.features.include?(:pclmulqdq) ? 2 : 3
+
           <<~EOS
             You have booted macOS using OpenCore Legacy Patcher.
             We do not provide support for this configuration.
 
-            #{support_tier_message(tier: 2)}
+            #{support_tier_message(tier: oclp_support_tier)}
           EOS
         end
 

Library/Homebrew/extend/os/mac/hardware/cpu.rb

@@ -40,7 +40,7 @@ def in_rosetta2?
           ::Hardware::CPU.sysctl_bool("sysctl.proc_translated")
         end
 
-        def features
+        def self.features
           @features ||= ::Hardware::CPU.sysctl_n(
             "machdep.cpu.features",
             "machdep.cpu.extfeatures",

docs/Installation.md

@@ -1,5 +1,5 @@
 ---
-last_review_date: "1970-01-01"
+last_review_date: "2025-04-12"
 ---
 
 # Installation
@@ -14,7 +14,6 @@ The macOS `.pkg` installer also installs Homebrew to its default prefix (`/opt/h
 
 * An Apple Silicon CPU or 64-bit Intel CPU <sup>[1](#1)</sup>
 * macOS Ventura (13) (or higher) installed on officially supported hardware<sup>[2](#2)</sup>
-  * **Note:** Devices using OpenCore Legacy Patcher are not supported
 * Command Line Tools (CLT) for Xcode (from `xcode-select --install` or
   [https://developer.apple.com/download/all/](https://developer.apple.com/download/all/)) or
   [Xcode](https://itunes.apple.com/us/app/xcode/id497799835) <sup>[3](#3)</sup>
@@ -119,7 +118,7 @@ Uninstallation is documented in the [FAQ](FAQ.md#how-do-i-uninstall-homebrew).
 
 <a data-proofer-ignore name="1"><sup>1</sup></a> For 32-bit or PPC support see [Tigerbrew](https://github.com/mistydemeo/tigerbrew).
 
-<a data-proofer-ignore name="2"><sup>2</sup></a> macOS 13 (Ventura) or higher is best and supported, 10.11 (El Capitan) – 12 (Monterey) are unsupported but may work and 10.10 (Yosemite) and older will not run Homebrew at all. For 10.4 (Tiger) – 10.6 (Snow Leopard) see [Tigerbrew](https://github.com/mistydemeo/tigerbrew).
+<a data-proofer-ignore name="2"><sup>2</sup></a> macOS 13 (Ventura) or higher is best and supported, 10.11 (El Capitan) – 12 (Monterey) are unsupported but may work and 10.10 (Yosemite) and older will not run Homebrew at all. For 10.4 (Tiger) – 10.6 (Snow Leopard) see [Tigerbrew](https://github.com/mistydemeo/tigerbrew). Using OpenCore Legacy Patcher is a [Tier 2 configuration](Support-Tiers.md#tier-2).
 
 <a data-proofer-ignore name="3"><sup>3</sup></a> You may need to install Xcode, the CLT, or both depending on the formula, to install a bottle (binary package) which is the only supported configuration. Downloading Xcode may require an Apple Developer account on older versions of Mac OS X. Sign up for free at [Apple's website](https://developer.apple.com/account/).
 

docs/Support-Tiers.md

@@ -23,7 +23,7 @@ A Tier 1 supported configuration is one in which:
 For Tier 1 support, Homebrew on macOS must be all of:
 
 - running on official Apple hardware (e.g. not a "Hackintosh" or VM)
-- running a version of macOS supported by Apple on that hardware (e.g. not using OpenCore Legacy Patcher)
+- running a version of macOS supported by Apple on that hardware
 - running a version of macOS with Homebrew CI coverage (i.e. the latest stable or prerelease version, two preceding versions)
 - installed in the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Intel x86_64)
 - running on a supported architecture (i.e. Apple Silicon or Intel x86_64)
@@ -63,6 +63,7 @@ Tier 2 configurations include:
 - using official packages that need to be built from source due to installing Homebrew outside the default prefix
   (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux)
 - running on a not-yet-supported architecture (i.e. Linux ARM64/AARCH64)
+- devices using OpenCore Legacy Patcher
 
 ## Tier 3