added lifecycles and bindings reference documentation

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-3/trunk@1169931 13f79535-47bb-0310-9956-ffa450edef68

maven-core/src/main/resources/META-INF/plexus/components.xml

@@ -98,6 +98,7 @@ under the License.
       <role-hint>clean</role-hint>
       <configuration>
         <id>clean</id>
+        <!-- START SNIPPET: clean -->
         <phases>
           <phase>pre-clean</phase>
           <phase>clean</phase>
@@ -108,6 +109,7 @@ under the License.
             org.apache.maven.plugins:maven-clean-plugin:2.4.1:clean
           </clean>
         </default-phases>
+        <!-- END SNIPPET: clean -->
       </configuration>
     </component>
 
@@ -118,6 +120,7 @@ under the License.
       <role-hint>site</role-hint>
       <configuration>
         <id>site</id>
+        <!-- START SNIPPET: site -->
         <phases>
           <phase>pre-site</phase>
           <phase>site</phase>
@@ -132,6 +135,7 @@ under the License.
             org.apache.maven.plugins:maven-site-plugin:2.0.1:deploy
           </site-deploy>
         </default-phases>
+        <!-- END SNIPPET: site -->
       </configuration>
     </component>
 

maven-core/src/site/apt/default-bindings.apt

@@ -0,0 +1,51 @@
+ ---
+ Bindings for Default Lifecycle Reference
+ ---
+ Hervé Boutemy
+ ---
+ 2011-09-12
+ ---
+  
+Bindings for <<<default>>> Lifecycle Reference
+
+  The {{{./lifecycles.html}default lifecycle}} is defined without any binding: bindings are defined separately and
+  are specific for each packaging:
+
+%{toc|fromDepth=2}
+
+* Bindings for <<<pom>>> packaging
+
+%{snippet|id=pom-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<jar>>> packaging
+
+%{snippet|id=jar-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<ejb>>> packaging
+
+%{snippet|id=ejb-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<ejb3>>> packaging
+
+%{snippet|id=ejb3-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<maven-plugin>>> packaging
+
+%{snippet|id=maven-plugin-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<war>>> packaging
+
+%{snippet|id=war-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<ear>>> packaging
+
+%{snippet|id=ear-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<rar>>> packaging
+
+%{snippet|id=rar-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+
+* Bindings for <<<par>>> packaging
+
+%{snippet|id=par-lifecycle|file=src/main/resources/META-INF/plexus/artifact-handlers.xml}
+  

maven-core/src/site/apt/lifecycles.apt

@@ -0,0 +1,32 @@
+ ---
+ Lifecycles Reference
+ ---
+ Hervé Boutemy
+ ---
+ 2011-09-12
+ ---
+  
+Lifecycles Reference
+
+  Maven defines 3 lifecycles:
+
+%{toc|fromDepth=2}
+
+* <<<default>>> Lifecycle
+
+  <<<default>>> lifecycle is defined without any associated.
+  Bindings are {{{./default-bindings.html}defined separately for every packaging}}:
+
+%{snippet|id=lifecycle|file=src/main/resources/META-INF/plexus/components.xml}
+
+* <<<clean>>> Lifecycle
+
+  <<<clean>>> lifecycle is defined directly with its bindings.
+
+%{snippet|id=clean|file=src/main/resources/META-INF/plexus/components.xml}
+
+* <<<site>>> Lifecycle
+
+  <<<site>>> lifecycle is defined directly with its bindings.
+
+%{snippet|id=site|file=src/main/resources/META-INF/plexus/components.xml}

maven-core/src/site/site.xml

@@ -30,6 +30,11 @@ under the License.
       <!--item name="FAQ" href="faq.html"/-->
     </menu>
 
+    <menu name="Reference">
+      <item name="Lifecycles" href="lifecycles.html"/>
+      <item name="Default Lifecycle Bindings" href="default-bindings.html"/>
+    </menu>
+
     <menu ref="parent"/>
     <menu ref="reports"/>
   </body>