brew/README.md

Homebrew
========
Features, usage and installation instructions are [summarized on the homepage][home].

What Packages Are Available?
----------------------------
1. You can [browse the Formula directory on GitHub][formula].
2. Or type `brew search` for a list.
3. Or visit [braumeister.org][braumeister] to browse packages online.
4. Or use [`brew desc`][brew-desc] to browse packages from the command line.

More Documentation
------------------
`brew help` or `man brew` or check our [wiki][].

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

Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/wiki/troubleshooting).

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

Who Are You?
------------
Homebrew's current maintainers are [Misty De Meo][mistydemeo], [Adam Vandenberg][adamv], [Jack Nagel][jacknagel], [Mike McQuaid][mikemcquaid] and [Brett Koonce][asparagui].

Homebrew was originally created by [Max Howell][mxcl].

License
-------
Code is under the [BSD 2 Clause (NetBSD) license][license].

Donations
---------
We accept tips through [Gittip][tip].

[![Gittip](https://img.shields.io/gittip/Homebrew.svg?style=flat)](https://www.gittip.com/Homebrew/)

[home]:http://brew.sh
[wiki]:https://github.com/Homebrew/homebrew/wiki
[mistydemeo]:https://github.com/mistydemeo
[adamv]:https://github.com/adamv
[jacknagel]:https://github.com/jacknagel
[mikemcquaid]:https://github.com/mikemcquaid
[asparagui]:https://github.com/asparagui
[mxcl]:https://github.com/mxcl
[formula]:https://github.com/Homebrew/homebrew/tree/master/Library/Formula/
[braumeister]:http://braumeister.org
[brew-desc]: https://github.com/telemachus/homebrew-desc
[license]:https://github.com/Homebrew/homebrew/tree/master/LICENSE.txt
[tip]:https://www.gittip.com/Homebrew/
I'll start with a rare Belgian yeast and Sussex hops 2009-05-21 00:04:11 +01:00			`Homebrew`
			`========`
README fix ups The point being to have less duplicate information. I am updating the wiki and the homepage accordingly. I am loathe to leave the "what packages are available" lines but I believe people who are interested in such things are likely to end up at the source root so it is appropriate. 2011-07-07 18:06:11 +01:00			`Features, usage and installation instructions are [summarized on the homepage][home].`
readme - how to find packages 2010-10-21 09:34:54 -07:00
README fix ups The point being to have less duplicate information. I am updating the wiki and the homepage accordingly. I am loathe to leave the "what packages are available" lines but I believe people who are interested in such things are likely to end up at the source root so it is appropriate. 2011-07-07 18:06:11 +01:00			`What Packages Are Available?`
			`----------------------------`
README: s/folder/directory/ Signed-off-by: Jack Nagel <jacknagel@gmail.com> 2012-02-24 19:51:20 -06:00			`1. You can [browse the Formula directory on GitHub][formula].`
README fix ups The point being to have less duplicate information. I am updating the wiki and the homepage accordingly. I am loathe to leave the "what packages are available" lines but I believe people who are interested in such things are likely to end up at the source root so it is appropriate. 2011-07-07 18:06:11 +01:00			2. Or type `brew search` for a list.
README: remove `brew server`. 2014-01-18 14:31:08 -08:00			`3. Or visit [braumeister.org][braumeister] to browse packages online.`
Tweak copy 2014-08-27 20:12:34 -05:00			4. Or use [`brew desc`][brew-desc] to browse packages from the command line.
readme - how to find packages 2010-10-21 09:34:54 -07:00
More descriptionless README tweaks It's nice that smaller READMEs are easier to get right. 2010-03-14 14:30:46 +00:00			`More Documentation`
README fix ups The point being to have less duplicate information. I am updating the wiki and the homepage accordingly. I am loathe to leave the "what packages are available" lines but I believe people who are interested in such things are likely to end up at the source root so it is appropriate. 2011-07-07 18:06:11 +01:00			`------------------`
			`brew help` or `man brew` or check our [wiki][].
Change license to BSD I confirmed this change with all relevant contributors first. 2009-08-31 16:01:36 +01:00
README: add troubleshooting. 2014-01-18 14:31:20 -08:00			`Troubleshooting`
			`---------------`
			First, please run `brew update` and `brew doctor`.

			`Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/wiki/troubleshooting).`

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

Documentation rewrite Much leaner README now. The website evangelises, and the Wiki is thorough. 2010-03-06 15:31:37 +00:00			`Who Are You?`
README fix ups The point being to have less duplicate information. I am updating the wiki and the homepage accordingly. I am loathe to leave the "what packages are available" lines but I believe people who are interested in such things are likely to end up at the source root so it is appropriate. 2011-07-07 18:06:11 +01:00			`------------`
README: use the word "maintainers". 2014-04-22 15:45:56 +01:00			`Homebrew's current maintainers are [Misty De Meo][mistydemeo], [Adam Vandenberg][adamv], [Jack Nagel][jacknagel], [Mike McQuaid][mikemcquaid] and [Brett Koonce][asparagui].`
README: show Homebrew core contributors. 2013-12-30 10:48:02 +00:00
			`Homebrew was originally created by [Max Howell][mxcl].`
Change license to BSD I confirmed this change with all relevant contributors first. 2009-08-31 16:01:36 +01:00
README.md: add license information. Closes Homebrew/homebrew#20241. Closes Homebrew/homebrew#20248. 2013-06-04 16:08:58 +01:00			`License`
			`-------`
			`Code is under the [BSD 2 Clause (NetBSD) license][license].`
Suggest use of the github gem when contributing Remove the lame beer related FAQs that make me look like an alcoholic. 2009-10-15 09:09:01 +01:00
README: add Gittip link. Closes Homebrew/homebrew#20482. 2014-01-03 21:42:54 +00:00			`Donations`
			`---------`
			`We accept tips through [Gittip][tip].`

Use flat style gittip button This matches the new markdown styling a bit better. 2014-08-04 21:08:31 -05:00			`[![Gittip](https://img.shields.io/gittip/Homebrew.svg?style=flat)](https://www.gittip.com/Homebrew/)`
README: add Gittip link. Closes Homebrew/homebrew#20482. 2014-01-03 21:42:54 +00:00
New Homepage: brew.sh 2013-03-25 23:55:04 -03:00			`[home]:http://brew.sh`
README: update links, team. 2014-04-10 09:51:53 +01:00			`[wiki]:https://github.com/Homebrew/homebrew/wiki`
			`[mistydemeo]:https://github.com/mistydemeo`
			`[adamv]:https://github.com/adamv`
			`[jacknagel]:https://github.com/jacknagel`
			`[mikemcquaid]:https://github.com/mikemcquaid`
			`[asparagui]:https://github.com/asparagui`
			`[mxcl]:https://github.com/mxcl`
			`[formula]:https://github.com/Homebrew/homebrew/tree/master/Library/Formula/`
Add a link to braumeister.org to the README Closes Homebrew/homebrew#10049. Signed-off-by: Jack Nagel <jacknagel@gmail.com> 2012-02-08 18:06:13 +01:00			`[braumeister]:http://braumeister.org`
brew-desc: Add a mention of brew-desc to README Closes Homebrew/homebrew#29555. Signed-off-by: Jack Nagel <jacknagel@gmail.com> 2014-05-24 15:36:00 -04:00			`[brew-desc]: https://github.com/telemachus/homebrew-desc`
LICENSE: move to root folder. This is where people expect to find it so let's make it easier. Closes Homebrew/homebrew#28418. 2014-04-22 15:59:22 +01:00			`[license]:https://github.com/Homebrew/homebrew/tree/master/LICENSE.txt`
README: add Gittip link. Closes Homebrew/homebrew#20482. 2014-01-03 21:42:54 +00:00			`[tip]:https://www.gittip.com/Homebrew/`