[Generator::Xcconfig] Docs

lib/cocoapods/generator/xcconfig/aggregate_xcconfig.rb

 module Pod
   module Generator
 
+    # Generates the xcconfigs for the aggregate targets.
     #
     class AggregateXCConfig < XCConfig
 
-      # Generates the xcconfig for the Pod integration target.
+      # Generates the xcconfig.
       #
       # @note   The xcconfig file for a Pods integration target includes the
       #         namespaced xcconfig files for each spec target dependency.

lib/cocoapods/generator/xcconfig/private_pod_xcconfig.rb

 module Pod
   module Generator
 
+    # Generates the private xcconfigs for the pod targets.
+    #
+    # The private xcconfig file for a Pod target merges the configuration
+    # values of the public namespaced xcconfig with the default private
+    # configuration values required by CocoaPods.
     #
     class PrivatePodXCConfig < XCConfig
 
-      # Generates the xcconfig for the target.
-      #
-      # @note   The private xcconfig file for a spec target includes the public
-      #         namespaced xcconfig file and merges the configuration values
-      #         with the default private configuration values.
+      # Generates the xcconfig.
       #
       # @return [Xcodeproj::Config]
       #

lib/cocoapods/generator/xcconfig/public_pod_xcconfig.rb

 module Pod
   module Generator
 
+    # Generates the public xcconfigs for the pod targets.
+    #
+    # The public xcconfig file for a Pod is completely namespaced to prevent
+    # configuration value collision with the build settings of other Pods. This
+    # xcconfig includes the standard podspec defined values including
+    # libraries, frameworks, weak frameworks and xcconfig overrides.
     #
     class PublicPodXCConfig < XCConfig
 
@@ -9,10 +15,6 @@ module Pod
       # @param  [Pathname] path
       #         the path where the prefix header should be stored.
       #
-      # @note   The public xcconfig file for a spec target is completely
-      #         namespaced to prevent configuration value collision with other
-      #         spec configurations.
-      #
       # @return [void]
       #
       def save_as(path)
@@ -21,10 +23,6 @@ module Pod
 
       # Generates the xcconfig for the target.
       #
-      # @note   The xcconfig file for a public spec target includes the
-      #         standard podspec defined values including libraries,
-      #         frameworks, weak frameworks and xcconfig overrides.
-      #
       # @return [Xcodeproj::Config]
       #
       def generate