Cleanup help banners.

lib/cocoapods/command.rb

@@ -30,16 +30,16 @@ module Pod
     end
 
     def self.banner
-      "### Commands\n" +
-      "\n" +
-      "  * setup\n" +
-      "  * install\n" +
-      "  * repo"
+      "To see help for the available commands run:\n" \
+      "\n" \
+      "  * $ pod setup --help\n" \
+      "  * $ pod install --help\n" \
+      "  * $ pod repo --help"
     end
 
     def self.options
-      "    --help      Show help information\n" +
-      "    --silent    Print nothing\n" +
+      "    --help      Show help information\n" \
+      "    --silent    Print nothing\n" \
       "    --verbose   Print more information while working"
     end
 

lib/cocoapods/command/install.rb

@@ -2,14 +2,14 @@ module Pod
   class Command
     class Install < Command
       def self.banner
-%{### Installing dependencies of a spec
+%{Installing dependencies of a pod spec:
 
     $ pod install [NAME]
 
       Downloads all dependencies of the specified podspec file `NAME' and
-      creates an Xcode Pods library project of the specified podspec file
-      `NAME'. In case `NAME' is omitted, it defaults to `Podfile' in the
-      current working directory.
+      creates an Xcode Pods library project in `./Pods'. In case `NAME' is
+      omitted it defaults to either `Podfile' or `*.podspec' in the current
+      working directory.
 }
       end
 

lib/cocoapods/command/repo.rb

@@ -4,7 +4,7 @@ module Pod
   class Command
     class Repo < Command
       def self.banner
-%{### Managing spec-repos
+%{Managing spec-repos:
 
     $ pod help repo
 

lib/cocoapods/command/setup.rb

@@ -2,12 +2,14 @@ module Pod
   class Command
     class Setup < Command
       def self.banner
-%{### Setup CocoaPods environment
+%{Setup CocoaPods environment:
 
     $ pod setup
 
       Creates a directory at `~/.cocoapods' which will hold your spec-repos.
-      This is where it will create a clone of the public `master' spec-repo.}
+      This is where it will create a clone of the public `master' spec-repo from:
+
+          https://github.com/alloy/cocoapods-specs}
       end
 
       def initialize(argv)

lib/cocoapods/command/spec.rb

@@ -2,7 +2,7 @@ module Pod
   class Command
     class Spec < Command
       def self.banner
-%{### Managing PodSpec files
+%{Managing PodSpec files:
 
     $ pod help spec