[Doc] Improved wording / fixed typos

lib/cocoapods/generator/embed_frameworks_script.rb

@@ -2,7 +2,7 @@ module Pod
   module Generator
     class EmbedFrameworksScript
       # @return [TargetDefinition] The target definition, whose label will be
-      #         used to locate the target specific build products.
+      #         used to locate the target-specific build products.
       #
       attr_reader :target_definition
 

lib/cocoapods/generator/module_map.rb

 module Pod
   module Generator
-    # Generates the LLVM module map files. A module map file is generated for
-    # each Pod and for each Pod target definition, that requires to be built as
-    # framework. It specifies a different umbrella header then usual to avoid
-    # name conflicts with existing headers of the podspec.
+    # Generates LLVM module map files. A module map file is generated for each
+    # Pod and for each Pod target definition, that is built as framework. It
+    # specifies a different umbrella header then usual to avoid name conflicts
+    # with existing headers of the podspec.
     #
     class ModuleMap
       # @return [Target] the target represented by this Info.plist.

lib/cocoapods/generator/xcconfig/aggregate_xcconfig.rb

@@ -84,7 +84,7 @@ module Pod
           pod_targets.each do |pod_target|
             XCConfigHelper.add_settings_for_file_accessors_of_target(pod_target, @xcconfig)
 
-            # Add pod framework to list of frameworks / libraries that are
+            # Add pod target to list of frameworks / libraries that are
             # linked with the user’s project.
             next unless pod_target.should_build?
             if pod_target.requires_framework?

lib/cocoapods/sandbox/headers_store.rb

@@ -27,7 +27,7 @@ module Pod
       end
 
       # @param  [Platform] platform
-      #         indicate for which platform the header search paths should be
+      #         the platform for which the header search paths should be
       #         returned
       #
       # @return [Array<String>] All the search paths of the header directory in

lib/cocoapods/target.rb

@@ -88,7 +88,7 @@ module Pod
 
     #-------------------------------------------------------------------------#
 
-    # @return [Boolean] whether the generated target need to be implemented
+    # @return [Boolean] whether the generated target needs to be implemented
     #         as a framework
     #
     # @note This applies either if Swift was used by the host, which was checked