TODO comments.

lib/cocoapods/generator/documentation.rb

@@ -78,6 +78,8 @@ module Pod
         options = appledoc_options
         options += ['--output', @target_path.to_s]
         options += install ? ['--create-docset'] : ['--no-create-docset']
+        # TODO: passing the files explicitly clutters output and chokes on very long list (AWSiOSSDK Spec).
+        # It is possible to just pass the dir of the pod, however this would include other files like demo projects.
         options += files
 
         @target_path.mkpath

lib/cocoapods/local_pod.rb

@@ -142,6 +142,8 @@ module Pod
     def add_to_target(target)
       sources_files_by_specification.each do | spec, files |
         files.each do |file|
+          # TODO: Xcodeproj::Project::Object::PBXNativeTarget#add_source_file is quite slow
+          # The issus appears to be related to the find call in line 107.
           target.add_source_file(file, nil, spec.compiler_flags.strip)
         end
       end