diff --git a/doc/install/Homebrew.mdwn b/doc/install/Homebrew.mdwn
index 68b8757cf3..bd9a840b0f 100644
--- a/doc/install/Homebrew.mdwn
+++ b/doc/install/Homebrew.mdwn
@@ -1,3 +1,21 @@
-[Homebrew](http://brew.sh/) has a formula for git-annex.
+[Homebrew](http://brew.sh/) has [a formula](https://github.com/Homebrew/homebrew/commits/master/Library/Formula/git-annex.rb) for git-annex.
 
 Homebrew users can simply run `brew install git-annex` to install git-annex.
+
+## buiding git-annex from sources
+
+This is the old recipe for building git-annex from source, using
+packages from homebrew. Useful if you want a newer version than the version
+in homebrew.
+
+<pre>
+brew install haskell-platform git ossp-uuid md5sha1sum coreutils gnutls libidn gsasl pkg-config libxml2
+brew link libxml2 --force
+cabal update
+mkdir $HOME/bin
+PATH=$HOME/bin:$PATH
+PATH=$HOME/.cabal/bin:$PATH
+cabal install c2hs --bindir=$HOME/bin
+cabal install gnuidn
+cabal install git-annex --bindir=$HOME/bin
+</pre>
diff --git a/doc/install/OSX.mdwn b/doc/install/OSX.mdwn
index 48bc90e08e..331f83e917 100644
--- a/doc/install/OSX.mdwn
+++ b/doc/install/OSX.mdwn
@@ -26,10 +26,7 @@ several more. Handy if you don't otherwise have git installed.
 
 ## using Homebrew
 
-<pre>
-brew update
-brew install git-annex
-</pre>
+git-annex is now [[available in Homebrew|Homebrew]]!
 
 ## using MacPorts