macos/homebrew-fuse
1
0
Fork 0
mirror of https://github.com/gromgit/homebrew-fuse.git synced 2025-12-06 16:15:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

README.md: expand on docs

Browse source
This commit is contained in:
Adrian Ho 2021-05-22 15:28:55 +08:00 • committed by GitHub
parent aa47507bda
commit 8f72a8feec
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 26 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

32
README.md
View file

@ -3,20 +3,40 @@
This tap exists to support macOS FUSE-related software that have been dropped from Homebrew core. This tap exists to support macOS FUSE-related software that have been dropped from Homebrew core.
## How do I install these formulae? ## How do I install these formulae?
`brew install gromgit/fuse/<formula>`
First, if you've already installed FUSE formulae from the core tap _before_ they were disabled, you might _not_ want to switch over to my formulae, because:
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.
But if you _do_ want to install my formulae over the core ones, you should uninstall the latter first:
```
brew uninstall XYZ
brew install gromgit/fuse/XYZ-mac
```
## Documentation ## Documentation
`brew help`, `man brew` or check [Homebrew's documentation](https://docs.brew.sh). `brew help`, `man brew` or check [Homebrew's documentation](https://docs.brew.sh).
## FAQ ## FAQ
### Why is XYZ not available? ### Why is XYZ not available?
Probably because I haven't gotten around to putting it in yet. If you need it, [file an issue](https://github.com/gromgit/homebrew-fuse/issues/new/choose) and I'll see what can be done.
Possible reasons:
1. All available versions of `XYZ` require version 3 of the libfuse API, but macFUSE only supports v2.
2. I might not have gotten around to getting it up. [File an issue](https://github.com/gromgit/homebrew-fuse/issues/new/choose) to get my attention. 😀
### Why is XYZ so old? ### Why is XYZ so old?
Maybe I just haven't gotten around to updating it yet, but a significant subset simply can't be updated until MacFUSE supports version 3 of the FUSE API. These will be labeled as such in their _Caveats_.
Other formulae seem to have been abandoned by their authors. If you know of a revived fork of such software, [file an issue](https://github.com/gromgit/homebrew-fuse/issues/new/choose) with the details and I'll see what can be done. Possible reasons:
1. Current `XYZ` requires libfuse v3, so I found and bottled the last version that requires libfuse v2.
2. `XYZ` was abandoned by its authors. If you know of a revived fork of such software, [file an issue](https://github.com/gromgit/homebrew-fuse/issues/new/choose) with the details and I'll see what can be done.
3. I might not have gotten around to updating it yet. [File an issue](https://github.com/gromgit/homebrew-fuse/issues/new/choose) to get my attention. 😀
### Why is the XYZ program installed as `XYZ-mac`? ### Why is your formula called `XYZ-mac`?
Some formulae (e.g. `rclone`) are still available in Homebrew core, just without FUSE functionality and dependencies. My FUSE-enabled binaries for these formulae will always be name with a `-mac` suffix to prevent naming conflicts, but see each formula's _Caveats_ section for instructions on how to access these binaries via their original names.
To avoid a naming conflict with the formula called `XYZ` that still exists in Homebrew core.
### Why is the XYZ _program_ installed as `XYZ-mac`?
`brew info gromgit/fuse/XYZ-mac` and read the _Caveats_ section.