docs/FAQ: correct an entry regarding simple formula edit

Co-authored-by: Kevin <apainintheneck@gmail.com>
This commit is contained in:
Sanjito Kurniawan 2023-02-09 17:57:47 +01:00 committed by Mike McQuaid
parent 2daae5e84d
commit c7b8b3a989
No known key found for this signature in database
GPG Key ID: 3338A31AFDB1D829

View File

@ -142,6 +142,8 @@ If all maintainer feedback has been addressed and all tests are passing, bump it
Yes! Its easy! Just `brew edit <formula>`. You dont have to submit modifications back to `homebrew/core`, just edit the formula to what you personally need and `brew install <formula>`. 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! Its easy! Just `brew edit <formula>`. You dont have to submit modifications back to `homebrew/core`, just edit the formula to what you personally need and `brew install <formula>`. 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? ## Can I make new formulae?
Yes! Its 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 <formula>`. If you encounter any issues, run the command with the `--debug` switch like so: `brew install --debug <formula>`, which drops you into a debugging shell. Yes! Its 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 <formula>`. If you encounter any issues, run the command with the `--debug` switch like so: `brew install --debug <formula>`, which drops you into a debugging shell.