Improve the output of cap --help.

Remove options documentation for rake options that aren't applicable
to capistrano, briefly explain correct cap usage, and point users to
http://capistranorb.com.
Merge pull request #1023 from mbrictson/improve-help

Improve the output of cap --help.