Author: carlos
Date: Thu Oct 18 15:34:12 2007
New Revision: 586161

URL: http://svn.apache.org/viewvc?rev=586161&view=rev
Log:
Add doc about packaging dependencies' sources

Added:
    
maven/plugins/trunk/maven-dependency-plugin/src/site/apt/examples/using-dependencies-sources.apt
   (with props)
Modified:
    maven/plugins/trunk/maven-dependency-plugin/src/site/site.xml

Added: 
maven/plugins/trunk/maven-dependency-plugin/src/site/apt/examples/using-dependencies-sources.apt
URL: 
http://svn.apache.org/viewvc/maven/plugins/trunk/maven-dependency-plugin/src/site/apt/examples/using-dependencies-sources.apt?rev=586161&view=auto
==============================================================================
--- 
maven/plugins/trunk/maven-dependency-plugin/src/site/apt/examples/using-dependencies-sources.apt
 (added)
+++ 
maven/plugins/trunk/maven-dependency-plugin/src/site/apt/examples/using-dependencies-sources.apt
 Thu Oct 18 15:34:12 2007
@@ -0,0 +1,69 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements.  See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership.  The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License.  You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied.  See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.    
+ 
+  ------
+  Unpacking project dependencies
+  ------
+  Carlos Sanchez
+  ------
+  Oct 2007
+  ------
+
+Using project dependencies' sources
+
+  This is pretty similar to the {{{copying-project-dependencies.html}Copying 
project dependencies}}
+  or {{{unpacking-project-dependencies.html}Unpacking project dependencies}} 
+  examples.
+
+  Instead of using the project dependencies it uses their sources. Use the 
goal 
+  <<<copy-dependencies>>> to just copy the sources jars to a directory or
+  <<<unpack-dependencies>>> to extract them.
+  See the sample below:
+
++---+
+<project>
+  [...]
+  <build>
+   <plugins>
+     <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-dependency-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>src-dependencies</id>
+            <phase>package</phase>
+            <goals>
+              <!-- use copy-dependencies instead if you don't want to explode 
the sources -->
+              <goal>unpack-dependencies</goal>
+            </goals>
+            <configuration>
+              <classifier>sources</classifier>
+              
<failOnMissingClassifierArtifact>false</failOnMissingClassifierArtifact>
+              
<outputDirectory>${project.build.directory}/sources</outputDirectory>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+  [...]
+</project>
++---+
+
+
+
+

Propchange: 
maven/plugins/trunk/maven-dependency-plugin/src/site/apt/examples/using-dependencies-sources.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: 
maven/plugins/trunk/maven-dependency-plugin/src/site/apt/examples/using-dependencies-sources.apt
------------------------------------------------------------------------------
    svn:keywords = "Author Date Id Revision"

Modified: maven/plugins/trunk/maven-dependency-plugin/src/site/site.xml
URL: 
http://svn.apache.org/viewvc/maven/plugins/trunk/maven-dependency-plugin/src/site/site.xml?rev=586161&r1=586160&r2=586161&view=diff
==============================================================================
--- maven/plugins/trunk/maven-dependency-plugin/src/site/site.xml (original)
+++ maven/plugins/trunk/maven-dependency-plugin/src/site/site.xml Thu Oct 18 
15:34:12 2007
@@ -33,6 +33,7 @@
       <item name="Copying project dependencies" 
href="examples/copying-project-dependencies.html" />
       <item name="Unpacking specific artifacts" 
href="examples/unpacking-artifacts.html" />
       <item name="Unpacking the project dependencies" 
href="examples/unpacking-project-dependencies.html" />
+      <item name="Using project dependencies' sources" 
href="examples/using-dependencies-sources.html" />
          <item name="Failing the build on dependency analysis warnings" 
href="examples/failing-the-build-on-dependency-analysis-warnings.html"/>
     </menu>
     <menu name="Resources">


Reply via email to