Updated formula to meet cookbook guidelines.

Replaced /usr/local with  HOMEBREW_PREFIX, removed extraneous comments
and added => :build for the packages required to (optionally) build the
docs.