homebrew-fuse/README.md

# gromgit's macOS FUSE stuff

This tap exists to support macOS FUSE-related software that have been dropped from Homebrew core.

## How do I install these formulae?

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

`brew help`, `man brew` or check [Homebrew's documentation](https://docs.brew.sh).

## FAQ

### Why is XYZ not available?

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?

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 your formula called `XYZ-mac`?

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.

### Why can't I build XYZ on an M1 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'm still looking for a solution to this; for now, if you really need to run any of these formulae on an M1 Mac, you'll have to set up a Rosetta-based Homebrew installation:
```
arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
/usr/local/bin/brew install <FUSE_formula>
```
Update README.md 2021-03-24 23:34:09 +08:00			`# gromgit's macOS FUSE stuff`

Update README 2021-04-27 01:39:28 +08:00			`This tap exists to support macOS FUSE-related software that have been dropped from Homebrew core.`
Create gromgit/fuse tap 2021-01-10 18:38:26 +08:00
			`## How do I install these formulae?`
README.md: expand on docs 2021-05-22 15:28:55 +08:00
			`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`
			```
Create gromgit/fuse tap 2021-01-10 18:38:26 +08:00
README: add some structure and clarity 2021-05-06 18:28:52 +08:00			`## Documentation`
README.md: expand on docs 2021-05-22 15:28:55 +08:00
README: add some structure and clarity 2021-05-06 18:28:52 +08:00			`brew help`, `man brew` or check [Homebrew's documentation](https://docs.brew.sh).

			`## FAQ`

			`### Why is XYZ not available?`
README.md: expand on docs 2021-05-22 15:28:55 +08:00
			`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. 😀`
Update README.md 2021-03-24 23:34:09 +08:00
README: add some structure and clarity 2021-05-06 18:28:52 +08:00			`### Why is XYZ so old?`
README: expanded instructions 2021-05-06 18:26:01 +08:00
README.md: expand on docs 2021-05-22 15:28:55 +08:00			`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 your formula called `XYZ-mac`?

			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`?
README: expanded instructions 2021-05-06 18:26:01 +08:00
README.md: expand on docs 2021-05-22 15:28:55 +08:00			`brew info gromgit/fuse/XYZ-mac` and read the _Caveats_ section.
README: add M1-specific info 2021-06-30 00:00:41 +08:00
			`### Why can't I build XYZ on an M1 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'm still looking for a solution to this; for now, if you really need to run any of these formulae on an M1 Mac, you'll have to set up a Rosetta-based Homebrew installation:
			```
			`arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
			`/usr/local/bin/brew install <FUSE_formula>`
			```