From fa3bfc796db180a297a5cd226e0941634af042ed Mon Sep 17 00:00:00 2001 From: Steve Matsumoto Date: Tue, 18 Jul 2023 10:32:18 -0400 Subject: [PATCH] docs/FAQ: tap homebrew/core before editing formula New installs don't tap `homebrew/core`, so `brew edit foo` fails with `Error: Invalid usage: foo doesn't exist on disk.` for any package. Add an instruction to run `brew tap homebrew/core` first, which fixes this issue. --- docs/FAQ.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index d9b34c01fc..c76562874f 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -140,7 +140,7 @@ If all maintainer feedback has been addressed and all tests are passing, bump it ## Can I edit formulae myself? -Yes! It’s easy! Just `brew edit `. You don’t have to submit modifications back to `homebrew/core`, just edit the formula to what you personally need and `brew install `. As a bonus, `brew update` will merge your changes with upstream so you can still keep the formula up-to-date **with** your personal modifications! +Yes! It’s easy! If `brew tap` doesn't show `homebrew/core`, run `brew tap homebrew/core` first. Then just `brew edit `. You don’t have to submit modifications back to `homebrew/core`, just edit the formula to what you personally need and `brew install `. As a bonus, `brew update` will merge your changes with upstream so you can still keep the formula up-to-date **with** your personal modifications! Note that if you are editing a core formula or cask you must set `HOMEBREW_NO_INSTALL_FROM_API=1` before using `brew install` or `brew update` otherwise they will ignore your local changes and default to the API.