[Doc] Minor fixes

lib/cocoapods/generator/embed_frameworks_script.rb

 module Pod
   module Generator
     class EmbedFrameworksScript
-      # @return [Hash{String, Array{String}] Multiple lists of frameworks per
+      # @return [Hash{String => Array<String>}] Multiple lists of frameworks per
       #         configuration.
       #
       attr_reader :frameworks_by_config
 
-      # @param  [Hash{String, Array{String}] frameworks_by_config
+      # @param  [Hash{String => Array<String>] frameworks_by_config
       #         @see #frameworks_by_config
       #
       def initialize(frameworks_by_config)

lib/cocoapods/generator/xcconfig/aggregate_xcconfig.rb

@@ -84,7 +84,7 @@ module Pod
         # from the integrating target by all sort of imports, which are:
         #  - `#import <…>`
         #  - `#import "…"`
-        #  - `@import …` / `@import …;`
+        #  - `@import …;` / `import …`
         #
         def generate_settings_to_import_pod_targets
           if target.requires_frameworks?

lib/cocoapods/installer/analyzer.rb

@@ -322,7 +322,7 @@ module Pod
         end
       end
 
-      # Finds the names of the Pods on which the given target _transitively_
+      # Finds the names of the Pods upon which the given target _transitively_
       # depends.
       #
       # @note: This is implemented in the analyzer, because we don't have to

lib/cocoapods/installer/analyzer/analysis_result.rb

@@ -6,8 +6,8 @@ module Pod
         #
         attr_accessor :podfile_state
 
-        # @return [Hash{TargetDefinition => Array<Spec>}] the specifications
-        #         grouped by target.
+        # @return [Hash{TargetDefinition => Array<Specification>}] the
+        #         specifications grouped by target.
         #
         attr_accessor :specs_by_target
 

lib/cocoapods/installer/analyzer/target_inspection_result.rb

@@ -12,7 +12,7 @@ module Pod
         #
         attr_accessor :project_path
 
-        # @return [Array<String>] the uuid of the user'S targets
+        # @return [Array<String>] the uuid of the user's targets
         #
         attr_accessor :project_target_uuids