brew/share/doc/homebrew/README.md

README

Homebrew installs the stuff you need that Apple didn’t.

• Install Homebrew
• FAQ
• Tips n' Tricks
• Gems, Eggs and Perl Modules and Homebrew and Python

Please note: Homebrew is not 1.0 yet. Generally it works well, but when it doesn’t we’d hope you report the bug. If it’s still broken at 1.0 you have our permission to throw a strop and make a big fuss.

Troubleshooting

First, please run brew update and brew doctor.

Second, please read the Troubleshooting Checklist.

If you don’t read these it will take us far longer to help you with your problem.

However! Fixing build issues is easier than you think: try brew edit $FORMULA and see how you fare.

Contributing

In short:

1. Fork Homebrew.
2. brew create http://example.com/foo-0.1.tar.gz
3. git checkout -b foo
4. git commit Library/Formula/foo.rb && git push
5. Pull Request.

In long:

• Formula Cookbook
• Acceptable Formulae
• Ruby Style Guide

Community Forums

• @MacHomebrew
• homebrew@librelist.com (archive)
• freenode.net#machomebrew

News

• Homebrew 0.9.3 Superenv is here to save the day.
• Homebrew 0.9 brew-tap lands.
• Homebrew 0.8 has been released, including the “refactor” branch and some improved support for Fortran-based software.

Supporters

A list of the awesome people who gave £5 or more to our Kickstarter.