From c7b8b3a989a241e82fc40eb29493d16b32ce2fca Mon Sep 17 00:00:00 2001 From: Sanjito Kurniawan Date: Thu, 9 Feb 2023 17:57:47 +0100 Subject: [PATCH] docs/FAQ: correct an entry regarding simple formula edit Co-authored-by: Kevin --- docs/FAQ.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/FAQ.md b/docs/FAQ.md index 136839f9b7..cbdaaf9281 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -142,6 +142,8 @@ If all maintainer feedback has been addressed and all tests are passing, bump it 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! +Note that if you are editing a core formula or cask you must set `HOMEBREW_NO_INSTALL_WITH_API=1` before using `brew install` or `brew update` otherwise they will ignore your local changes and default to the API. + ## Can I make new formulae? Yes! It’s easy! Just `brew create URL`. Homebrew will then open the formula in `EDITOR` so you can edit it, but it probably already installs; try it: `brew install `. If you encounter any issues, run the command with the `--debug` switch like so: `brew install --debug `, which drops you into a debugging shell.