Merge pull request CocoaPods#235 from CocoaPods/kylef/podfile-pod-subspecs

[Podfile DSL] Document how subspecs can be included

Author: segiddins

CHANGELOG.md

@@ -5,7 +5,7 @@
 ##### Enhancements
 
 * Allow specifying multiple subspec pod dependencies inline in the Podfile,
-  via `pod 'Pod', subspecs: ['Subspec1', 'Subspec2']`.  
+  via `pod 'Pod', :subspecs => ['Subspec1', 'Subspec2']`.  
   [Samuel Giddins](https://github.com/segiddins)
   [#221](https://github.com/CocoaPods/Core/issues/221)
 

lib/cocoapods-core/podfile/dsl.rb

@@ -112,6 +112,21 @@ module DSL
       #
       # ------
       #
+      # ### Subspecs
+      #
+      # When installing a Pod via it's name, it will install all of the
+      # default subspecs defined in the podspec.
+      #
+      # You may install a specific subspec using the following:
+      #
+      #     pod 'QueryKit/Attribute'
+      #
+      # You may specify a collection of subspecs to be installed as follows:
+      #
+      #     pod 'QueryKit', :subspecs => ['Attribute', 'QuerySet']
+      #
+      # ------
+      #
       # Dependencies can be obtained also from external sources.
       #
       #