Add versions command to the man page

Additionally, document the '--build-from-source' option for the
`install` command.

Library/Contributions/manpages/brew.1.md

@@ -116,7 +116,7 @@ For the full command list, see the COMMANDS section.
   * `info` <URL>:
     Print the name and version that will be detected for <URL>.
 
-  * `install [--force] [--debug] [--ignore-dependencies] [--use-clang] [--use-gcc] [--use-llvm] [--HEAD]` <formula>:
+  * `install [--force] [--debug] [--ignore-dependencies] [--use-clang] [--use-gcc] [--use-llvm] [--build-from-source] [--HEAD]` <formula>:
     Install <formula>.
 
     <formula> is usually the name of the formula to install, but may also be
@@ -141,6 +141,9 @@ For the full command list, see the COMMANDS section.
     If `--use-llvm` is passed, attempt to compile using the LLVM front-end to GCC.
     *NOTE*: Not all formulae will build with LLVM.
 
+    If `--build-from-source` is passed, compile from source even if a bottle
+    is provided for <formula>.
+
     If `--HEAD` is passed, and <formula> defines it, install the HEAD version,
     aka master, trunk, unstable, dev.
 
@@ -233,6 +236,10 @@ For the full command list, see the COMMANDS section.
 
     If `--installed` is passed, only lists installed formulae.
 
+  * `versions` <formulae>:
+    List previous versions of <formulae>, along with a command to checkout
+    each version.
+
   * `which` [<formulae>]:
     List versions of installed brews.
 

share/man/man1/brew.1

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "BREW" "1" "July 2011" "Homebrew" "brew"
+.TH "BREW" "1" "August 2011" "Homebrew" "brew"
 .
 .SH "NAME"
 \fBbrew\fR \- The missing package manager for OS X
@@ -136,7 +136,7 @@ To view formula history locally: \fBbrew log \-p <formula>\fR\.
 Print the name and version that will be detected for \fIURL\fR\.
 .
 .TP
-\fBinstall [\-\-force] [\-\-debug] [\-\-ignore\-dependencies] [\-\-use\-clang] [\-\-use\-gcc] [\-\-use\-llvm] [\-\-HEAD]\fR \fIformula\fR
+\fBinstall [\-\-force] [\-\-debug] [\-\-ignore\-dependencies] [\-\-use\-clang] [\-\-use\-gcc] [\-\-use\-llvm] [\-\-build\-from\-source] [\-\-HEAD]\fR \fIformula\fR
 Install \fIformula\fR\.
 .
 .IP
@@ -161,6 +161,9 @@ If \fB\-\-use\-gcc\fR is passed, attempt to compile using GCC\. This is useful f
 If \fB\-\-use\-llvm\fR is passed, attempt to compile using the LLVM front\-end to GCC\. \fINOTE\fR: Not all formulae will build with LLVM\.
 .
 .IP
+If \fB\-\-build\-from\-source\fR is passed, compile from source even if a bottle is provided for \fIformula\fR\.
+.
+.IP
 If \fB\-\-HEAD\fR is passed, and \fIformula\fR defines it, install the HEAD version, aka master, trunk, unstable, dev\.
 .
 .IP
@@ -260,6 +263,10 @@ Show the formulas that specify \fIformula\fR as a dependency\. The list is not r
 If \fB\-\-installed\fR is passed, only lists installed formulae\.
 .
 .TP
+\fBversions\fR \fIformulae\fR
+List previous versions of \fIformulae\fR, along with a command to checkout each version\.
+.
+.TP
 \fBwhich\fR [\fIformulae\fR]
 List versions of installed brews\.
 .