admin/brew
1
0
Fork 0
Code Issues Packages Projects Releases 6 Wiki Activity

Reflect recent changes in the README

Browse Source
This commit is contained in:
Max Howell 2009-06-04 20:03:53 +01:00
parent ddfd15bcf2
commit a0920e4360
1 changed files with 29 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
README
View File

@ -3,74 +3,73 @@ Homebrew
A simple package management system for OS X Leopard. Packages are brewed in A simple package management system for OS X Leopard. Packages are brewed in
individual, versioned kegs. For example: individual, versioned kegs. For example:
/Brewery/Cellar/wget/1.11.4/bin/wget /usr/local/Cellar/wget/1.11.4/bin/wget
/Brewery/Cellar/wget/1.11.4/share/man/man1/wget.1 /usr/local/Cellar/wget/1.11.4/share/man/man1/wget.1
… …
And symlinks are created to allow a normal POSIX tree: And symlinks are created to allow a normal POSIX tree:
/Brewery/bin/wget -> /Brewery/Cellar/wget/1.11.4/bin/wget /usr/local/bin/wget -> /usr/local/Cellar/wget/1.11.4/bin/wget
/Brewery/etc/wgetrc -> /Brewery/Cellar/wget/1.11.4/etc/wgetrc /usr/local/etc/wgetrc -> /usr/local/Cellar/wget/1.11.4/etc/wgetrc
… …
This way the filesystem is the package database. Everything else is now easy. This way the filesystem is the package database. Everything else is now easy.
We are made of win. We are made of win.
Max Howell -- http://twitter.com/mxcl Max Howell <http://twitter.com/mxcl>
Installation Installation
============ ============
Homebrew uses Ruby and some other stuff that is already installed on Leopard. Homebrew uses Ruby and some other stuff that is already installed on Leopard.
Just copy this directory somewhere. I suggest /Brewery but leave the directory It is self-contained and ready to go. Just copy this directory somewhere. Things
user writable (for now). I wouldn't worry about it not being chroot. We don't work really well if you put it in /usr/local (especially if you are a
install anything base enough for it to be a concern (unlike MacPorts or Fink). developer).
I also recommend you make /usr/local user-writable. I wouldn't worry about it
not being chroot. We don't install anything base enough for it to be a concern
(unlike MacPorts or Fink).
You can stick this directory in your home directory if you like. In that case You can stick this directory in your home directory if you like. In that case
a typical (POSIX) choice would be: /User/mxcl/local a typical (POSIX) choice would be: /User/mxcl/.local
It's actually pretty useful if you are a developer to put the tree at If you don't install to /usr/local (but seriously it's great!) then you'll need
/usr/local because almost all build scripts look there as part of their to edit your ~/.profile file to add Homebrew's bin directory to the PATH.
configure step, so your work (outside of Homebrew) will be somewhat easier.
You then need to stick /Brewery/bin or ~/local/bin in your path.
To 'install' the brew tool to Homebrew's bin dir, do:
$ ruby /Brewery/Cellar/homebrew/brewkit.rb
Usage Usage
===== =====
Install wget: Install wget:
ruby /Brewery/Formula/wget.rb brew install wget
Update recipes list: Update recipes list:
cd /Brewery && git pull origin masterbrew cd /usr/local && git pull origin masterbrew
Delete a package: Delete a package:
rm -rf /Brewery/Cellar/wget && brew prune 1. rm -rf /usr/local/Cellar/wget && brew prune
2. brew rm wget
List all files in a package: List all files in a package:
find /Brewery/Cellar/wget 1. find /usr/local/Cellar/wget
2. brew list wget
Search for a package to install: Search for a package to install:
ls /Brewery/Formula/*wget* ls /usr/local/Library/Formula/*wget*
Search for a package already installed: Search for a package already installed:
ls /Brewery/Cellar/*wget* ls /usr/local/Cellar/*wget*
List all packages available to install: List all packages available to install:
ls /Brewery/Formula ls /Brewery/Library/Formula
Compute installed size of package: Compute installed size of package:
du -h /Brewery/Cellar/wget du -h /Brewery/Cellar/wget
You get the idea. You get the idea.
Maybe we should overload this stuff with the brew command, but frankly I feel Maybe we should overload more of this stuff with the brew command, but frankly I
that this way *you* will understand the capabilities of the system better. And feel that this way *you* will understand the capabilities of the system better.
you basically know everything that is going on. And you basically know everything that is going on.
With apt, you type apt-get install wget. Now what is happening? With Homebrew With apt, you type apt-get install wget. Now what is happening? With Homebrew
you are running a ruby script. You know what is happening. You can easily and you are running a ruby script. You know what is happening. You can easily and
@ -82,8 +81,6 @@ NOTE you have to install git before you can update the package list, but
that's easy: that's easy:
brew install git brew install git
or
ruby /Brewery/Formula/git.rb
Why Not MacPorts? Why Not MacPorts?
@ -148,6 +145,6 @@ Are you excessively interested in beer?
--------------------------------------- ---------------------------------------
Yes. Yes.
Was Homebrew devised under the influence of alchohol? Was Homebrew devised under the influence of alcohol?
----------------------------------------------------- -----------------------------------------------------
Yes. Yes.