brew/README.md

# Homebrew
Features, usage and installation instructions are [summarised on the homepage](http://brew.sh).

## What Packages Are Available?
1. Type `brew search` for a list.
2. Or visit [braumeister.org](http://braumeister.org) to browse packages online.
3. Or use [`brew desc`](https://github.com/telemachus/homebrew-desc) to browse packages from the command line.

## More Documentation
`brew help`, `man brew` or check [our documentation](https://github.com/Homebrew/homebrew/tree/master/share/doc/homebrew#readme).

## Troubleshooting
First, please run `brew update` and `brew doctor`.

Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md#troubleshooting).

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

## Security
Please report security issues to security@brew.sh.

## Who Are You?
Homebrew's current maintainers are [Misty De Meo](https://github.com/mistydemeo), [Adam Vandenberg](https://github.com/adamv), [Jack Nagel](https://github.com/jacknagel), [Xu Cheng](https://github.com/xu-cheng), [Mike McQuaid](https://github.com/mikemcquaid), [Brett Koonce](https://github.com/asparagui) and [Tim Smith](https://github.com/tdsmith).

Homebrew was originally created by [Max Howell](https://github.com/mxcl).

## License
Code is under the [BSD 2 Clause (NetBSD) license](https://github.com/Homebrew/homebrew/tree/master/LICENSE.txt).

## Donations
We accept tips through [Gratipay](https://gratipay.com/Homebrew/).

[![Gratipay](https://img.shields.io/gratipay/Homebrew.svg?style=flat)](https://gratipay.com/Homebrew/)

## Sponsors
Our CI infrastructure was paid for by [our Kickstarter supporters](https://github.com/Homebrew/homebrew/blob/master/SUPPORTERS.md).

Our CI infrastructure is hosted by [The Positive Internet Company](http://www.positive-internet.com).

Our bottles (binary packages) are hosted by Bintray.

[![Downloads by Bintray](https://bintray.com/docs/images/downloads_by_bintray_96.png)](https://bintray.com/homebrew)
Cleanup root documentation. 2014-10-26 15:23:42 +00:00			`# Homebrew`
			`Features, usage and installation instructions are [summarised on the homepage](http://brew.sh).`
readme - how to find packages 2010-10-21 09:34:54 -07:00
Cleanup root documentation. 2014-10-26 15:23:42 +00:00			`## What Packages Are Available?`
README: don't recommend browsing Library/Formula. It doesn't display all formulae any more. 2014-10-26 15:26:10 +00:00			1. Type `brew search` for a list.
			`2. Or visit [braumeister.org](http://braumeister.org) to browse packages online.`
			3. Or use [`brew desc`](https://github.com/telemachus/homebrew-desc) to browse packages from the command line.
readme - how to find packages 2010-10-21 09:34:54 -07:00
Cleanup root documentation. 2014-10-26 15:23:42 +00:00			`## More Documentation`
README: tweak documentation section. 2014-12-27 11:04:54 +00:00			`brew help`, `man brew` or check [our documentation](https://github.com/Homebrew/homebrew/tree/master/share/doc/homebrew#readme).
Change license to BSD I confirmed this change with all relevant contributors first. 2009-08-31 16:01:36 +01:00
Cleanup root documentation. 2014-10-26 15:23:42 +00:00			`## Troubleshooting`
README: add troubleshooting. 2014-01-18 14:31:20 -08:00			First, please run `brew update` and `brew doctor`.

Cleanup root documentation. 2014-10-26 15:23:42 +00:00			`Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md#troubleshooting).`
README: add troubleshooting. 2014-01-18 14:31:20 -08:00
			`If you don't read these it will take us far longer to help you with your problem.`

Cleanup root documentation. 2014-10-26 15:23:42 +00:00			`## Security`
Add security contact 2014-10-22 17:23:17 -05:00			`Please report security issues to security@brew.sh.`

Cleanup root documentation. 2014-10-26 15:23:42 +00:00			`## Who Are You?`
README: add xu-cheng to maintainers. 2015-02-23 14:21:16 +00:00			`Homebrew's current maintainers are [Misty De Meo](https://github.com/mistydemeo), [Adam Vandenberg](https://github.com/adamv), [Jack Nagel](https://github.com/jacknagel), [Xu Cheng](https://github.com/xu-cheng), [Mike McQuaid](https://github.com/mikemcquaid), [Brett Koonce](https://github.com/asparagui) and [Tim Smith](https://github.com/tdsmith).`
Cleanup root documentation. 2014-10-26 15:23:42 +00:00
			`Homebrew was originally created by [Max Howell](https://github.com/mxcl).`

			`## License`
			`Code is under the [BSD 2 Clause (NetBSD) license](https://github.com/Homebrew/homebrew/tree/master/LICENSE.txt).`

			`## Donations`
			`We accept tips through [Gratipay](https://gratipay.com/Homebrew/).`

README: update Gratipay badge link. Removes an unnecessary redirect from gittip.com to gratipay.com. Closes Homebrew/homebrew#37033. Signed-off-by: Mike McQuaid <mike@mikemcquaid.com> 2015-02-21 10:07:01 -08:00			`[![Gratipay](https://img.shields.io/gratipay/Homebrew.svg?style=flat)](https://gratipay.com/Homebrew/)`
README: add sponsors. 2015-02-23 14:20:12 +00:00
			`## Sponsors`
			`Our CI infrastructure was paid for by [our Kickstarter supporters](https://github.com/Homebrew/homebrew/blob/master/SUPPORTERS.md).`

			`Our CI infrastructure is hosted by [The Positive Internet Company](http://www.positive-internet.com).`

			`Our bottles (binary packages) are hosted by Bintray.`

			`[![Downloads by Bintray](https://bintray.com/docs/images/downloads_by_bintray_96.png)](https://bintray.com/homebrew)`