[Installer,TargetInstaller] Add API group.

lib/cocoapods/installer.rb

@@ -93,7 +93,9 @@ module Pod
 
     #-------------------------------------------------------------------------#
 
-    # @!group Installation products
+    # @!group API
+    #
+    # This is the tentative API for the podfile and the specification hooks.
 
     public
 
@@ -124,9 +126,12 @@ module Pod
     #
     attr_reader :names_of_pods_to_install
 
+    # @return [Array<Library>] The libraries generated by the installation
+    #         process.
+    #
     attr_reader :libraries
 
-    #-------------------------------------------------------------------------#
+    #--------------------------------------#
 
     # @!group Hooks compatiblity
 

lib/cocoapods/installer/target_installer.rb

@@ -7,15 +7,6 @@ module Pod
     #
     class TargetInstaller
 
-      # @return [Sandbox] sandbox the sandbox where the support files should
-      #         be generated.
-      #
-      attr_reader :sandbox
-
-      # @return [Library] The library whose target needs to be generated.
-      #
-      attr_reader :library
-
       # @param  [Project]           project @see project
       # @param  [TargetDefinition]  target_definition @see target_definition
       #
@@ -39,19 +30,23 @@ module Pod
         create_copy_resources_script
       end
 
-      # @todo This has to be removed, but this means the specs have to be
-      #       updated if they need a reference to the prefix header.
-      #
-      def prefix_header_filename
-        library.prefix_header_name
-      end
-
       #-----------------------------------------------------------------------#
 
-      # @!group Installation products.
+      # @!group API
+      #
+      # This is the tentative API for the podfile and the specification hooks.
 
       public
 
+      # @return [Sandbox] sandbox the sandbox where the support files should
+      #         be generated.
+      #
+      attr_reader :sandbox
+
+      # @return [Library] The library whose target needs to be generated.
+      #
+      attr_reader :library
+
       # @return [PBXNativeTarget] the target generated by the installation
       #         process.
       #
@@ -59,6 +54,18 @@ module Pod
       #
       attr_reader :target
 
+      #--------------------------------------#
+
+      # @!group Hooks compatiblity
+
+      # @todo This has to be removed, but this means the specs have to be
+      #       updated if they need a reference to the prefix header.
+      #
+      def prefix_header_filename
+        UI.warn "The usage of the TargetInstaller#prefix_header_filename is deprecated."
+        library.prefix_header_name
+      end
+
       #-----------------------------------------------------------------------#
 
       # @!group Installation steps