README: major update

This commit is contained in:
Adrian Ho 2025-02-10 21:31:50 +08:00
parent e4dae3c300
commit 5cec38ea10

View file

@ -4,9 +4,9 @@ This tap exists to support macOS FUSE-related software that have been dropped fr
--- ---
# !!! WARNING: Mojave Deprecation !!! # !!! WARNING: Reduced Build Coverage !!!
Homebrew dropped support for macOS Mojave as of 25 Oct 2021. I'll continue to build Mojave bottles for the FUSE formulae for now, but ***not*** for any external dependencies that they rely on, _especially core formulae_. Therefore, at some point in 2022, I will also no longer support Mojave in this tap. All my old Intel Mac hardware is dead, and I'm not inclined to spend additional resources spinning up VMs or building Hackintoshes at this stage. As of 2025-Feb-10, the only bottles built will be for those macOS versions supported by GitHub runners (currently Ventura on Intel and Sonoma on ARM). Sorry.
--- ---
@ -16,7 +16,7 @@ First, if you've already installed FUSE formulae from the core tap _before_ they
1. As far as I know, Homebrew will not remove them from your system, even after the formulae themselves are deleted. 1. As far as I know, Homebrew will not remove them from your system, even after the formulae themselves are deleted.
2. Many of these formulae are rather old, so you're unlikely to find updates anyway. 2. Many of these formulae are rather old, so you're unlikely to find updates anyway.
But if you _do_ want to install my formulae over the core ones, you should uninstall the latter first. But if you _do_ want to install my formulae over the core ones, you should uninstall the core formulae first.
## Documentation ## Documentation
@ -49,16 +49,8 @@ To avoid a naming conflict with the formula called `XYZ` that still exists in Ho
### Why does Homebrew say I need to build `XYZ-mac` from source? ### Why does Homebrew say I need to build `XYZ-mac` from source?
It's likely one of the following: All my old Intel Mac hardware is dead, so I'm relying now on the free GitHub runners to build bottles.
1. You're using an M1 Mac. I don't have one, so there are no bottles (for now).
2. You're running Homebrew on an Intel Mac in a non-standard location, so the existing bottles won't install for you.
### Why can't I build XYZ on an M1 Mac? ### Why can't I build XYZ on an ARM Mac?
Homebrew currently [filters out `/usr/local` entirely during M1-based builds](https://github.com/Homebrew/brew/blob/04532cb6216b69a5b067aa7a4e22cff0944b257d/Library/Homebrew/shims/super/cc#L266-L270). I've devised a workaround for this, and it works on Intel Big Sur with Homebrew installed in a non-standard location, but I don't have an M1 Mac, so I can't test it for real. If you still can't build it, please [file an issue](https://github.com/gromgit/homebrew-fuse/issues/new/choose). Homebrew currently [filters out `/usr/local` entirely during ARM-based builds](https://github.com/Homebrew/brew/blob/04532cb6216b69a5b067aa7a4e22cff0944b257d/Library/Homebrew/shims/super/cc#L266-L270). I've devised a workaround for this, that seems to work well on both Intel and ARM GitHub runners. If you still can't build it, please [file an issue](https://github.com/gromgit/homebrew-fuse/issues/new/choose).
If you need the software urgently, you'll have to set up a Rosetta-based Homebrew installation (which has prebuilt bottles):
```
arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
/usr/local/bin/brew install <FUSE_formula>
```