[Docs] Document new methods for the new Podfile DSL

lib/cocoapods/downloader.rb

@@ -20,9 +20,11 @@ module Pod
     #         the location to which this pod should be downloaded. If `nil`,
     #         then the pod will only be cached.
     #
+    # @param  [Boolean] can_cache
+    #         whether caching is allowed.
+    #
     # @param  [Pathname,Nil] cache_path
-    #         the path used to cache pod downloads. If `nil`, then no caching
-    #         will be done.
+    #         the path used to cache pod downloads.
     #
     def self.download(
       request,

lib/cocoapods/external_sources/abstract_external_source.rb

@@ -17,6 +17,8 @@ module Pod
       #
       attr_reader :podfile_path
 
+      # @return [Boolean] Whether the source is allowed to touch the cache.
+      #
       attr_accessor :can_cache
       alias_method :can_cache?, :can_cache
 

lib/cocoapods/generator/xcconfig/aggregate_xcconfig.rb

@@ -89,6 +89,9 @@ module Pod
 
         protected
 
+        # @return [Hash<String, String>] the build settings necessary to import
+        #         the pod targets.
+        #
         def settings_to_import_pod_targets
           if target.requires_frameworks?
             framework_header_search_paths = pod_targets.select(&:should_build?).map do |target|

lib/cocoapods/target/aggregate_target.rb

@@ -104,6 +104,9 @@ module Pod
     #
     attr_accessor :pod_targets
 
+    # @return [Array<AggregateTarget>] The aggregate targets whose pods this
+    #         target must be able to import, but will not directly link against.
+    #
     attr_accessor :search_paths_aggregate_targets
 
     # @param  [String] build_configuration The build configuration for which the