[#149] Install or generate documentation

- introduced '--generate_documentation' '--install_documentation' command
  line options
- only doc installation/generation only if pod does not exists

lib/cocoapods/command.rb

@@ -69,6 +69,8 @@ module Pod
       show_help = argv.option('--help')
       Config.instance.silent = argv.option('--silent')
       Config.instance.verbose = argv.option('--verbose')
+      Config.instance.generate_documentation  = argv.option('--generate_documentation')
+      Config.instance.install_documentation  = argv.option('--install_documentation')
 
       command_class = case argv.shift_argument
       when 'install' then Install

lib/cocoapods/config.rb

@@ -10,16 +10,20 @@ module Pod
       @instance = instance
     end
 
-    attr_accessor :repos_dir, :project_root, :project_pods_root, :rootspec, :clean, :verbose, :silent
+    attr_accessor :repos_dir, :project_root, :project_pods_root, :rootspec, :clean, :verbose, :silent, :install_documentation, :generate_documentation
     alias_method :clean?,   :clean
     alias_method :verbose?, :verbose
     alias_method :silent?,  :silent
+    alias_method :install_documentation?,  :install_documentation
+    alias_method :generate_documentation?,  :generate_documentation
 
     def initialize
       @repos_dir = Pathname.new(File.expand_path("~/.cocoapods"))
       @clean = true
       @verbose = false
       @silent = false
+      @install_documentation = false
+      @generate_documentation = false
     end
 
     def project_root

lib/cocoapods/installer.rb

@@ -51,7 +51,13 @@ module Pod
 
             downloader = Downloader.for_pod(pod)
             downloader.download
-
+            if config.generate_documentation && pod.can_generated_documentation
+              puts "Generating documentation for #{spec}" unless config.silent?
+              pods.each { |pod| pod.generate_documentation }
+            elsif config.install_documentation && pod.can_install_documentation
+              puts "Installing documentation for #{spec}" unless config.silent?
+              pods.each { |pod| pod.install_documentation }
+            end
             if config.clean
               downloader.clean
               pod.clean
@@ -82,9 +88,6 @@ module Pod
 
       puts "* Writing Xcode project file to `#{@sandbox.project_path}'" if config.verbose?
       project.save_as(@sandbox.project_path)
-
-      puts "Installing documentation" unless config.silent?
-      pods.each { |pod| pod.install_documentation }
     end
 
     def run_post_install_hooks

lib/cocoapods/local_pod.rb

@@ -75,6 +75,28 @@ module Pod
       end
     end
 
+    def can_generated_documentation
+      specification.documentation && specification.documentation[:appledoc]
+    end
+
+    def can_install_documentation
+      specification.documentation && specification.documentation[:appledoc]
+    end
+
+    def generate_documentation
+      if specification.documentation
+        appledoc_options = specification.documentation[:appledoc]
+        if appledoc_options
+          appledoc_options += ['--output', "#{@sandbox.root}/doc", '--no-create-docset']
+          appledoc_options += source_files
+          Open3.popen3('appledoc', *appledoc_options ) { |stdin, stdout, stderr|
+            puts stdout.read.chomp
+            puts stderr.read.chomp
+          }
+        end
+      end
+    end
+
     def install_documentation
       if specification.documentation
         appledoc_options = specification.documentation[:appledoc]