feature(delta): use WEBI_UA for curl.exe

[webi-installers/.git] / brew / README.md

diff --git a/brew/README.md b/brew/README.md
index 075d6b243137a64c18df1985a49e2ae2f9cedc80..581e4f6d9c670a1fedce350a5bcd0f760fdf0620 100644 (file)
--- a/brew/README.md
+++ b/brew/README.md
@@ -18,6 +18,12 @@ brew upgrade
 
 > Homebrew installs the stuff you need that Apple (or your Linux system) didn’t.
 
+**Important**: This will install `brew` to `~/.local/opt/brew/`, NOT
+`/usr/local`. The ability to install brew, without `sudo`, in your HOME
+directory is a relatively new feature. If you do encounter a `brew install`
+issue, [report it to brew](https://github.com/Homebrew/homebrew-core/issues).
+way, report it to brew.
+
 ### How to install CLI packages
 
 ```bash
@@ -34,7 +40,39 @@ brew cask install docker
 
 ### Where are things installed?
 
+```bash
+~/.local/opt/brew/
+```
+
+For reference, traditional `brew` installs here:
+
 ```bash
 /usr/local/Cellar/
 /opt/homebrew-cask/Caskroom/
 ```
+
+### `brew` screwed up everything, now what?
+
+Sometimes you're compelled against all reason to do something really stupid,
+like `brew upgrade` or `brew update python`, and your whole system gets borked.
+
+If you need to _uninstall_ and _reinstall_ local brew:
+
+```bash
+rm -rf ~/.local/opt/brew
+webi brew
+```
+
+If you need to _uninstall_ global brew:
+
+For _Mojave_, _Catalina_, _Big Sur_, and above:
+
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall.sh)"
+```
+
+For _High Sierra_ and below:
+
+```bash
+/bin/bash -c ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"
+```