Copy 1.5.1-RC4 tag as 1.5.1

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@822281 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 46 insertions, 0 deletions

diff --git a/tags/java/sca/1.5.1/tools/maven/maven-dependency-lister/README b/tags/java/sca/1.5.1/tools/maven/maven-dependency-lister/README
new file mode 100644
index 0000000000..d53760029f
--- /dev/null
+++ b/tags/java/sca/1.5.1/tools/maven/maven-dependency-lister/README
@@ -0,0 +1,46 @@
+Tuscany SCA Dependency Lister

+=============================

+

+Makes use of the extension Maven dependency support to list out all of the 

+dependencis in the module where the plugin is used. The module is

+analysed and a report (dependency.txt) is written into the modules directory including

+each dependency and the path through the maven transitive dependencies that caused

+the original dependency to be included. For example, Here is a line which lists

+a a jar dependency, the phase in which it was found, the module being processed 

+and he path that causes the dependency

+

+DEPENDENCY              PHASE   MODULE                                                          PATH TO DEPENDENCY

+jaxb-api-2.1.jar	compile	Apache Tuscany SCA Atom+RSS Feed Aggregator Sample Webapp	tuscany-host-webapp-1.1-incubating-SNAPSHOT	tuscany-host-embedded-1.1-incubating-SNAPSHOT	tuscany-core-databinding-1.1-incubating-SNAPSHOT	tuscany-databinding-jaxb-1.1-incubating-SNAPSHOT	jaxb-api-2.1

+

+It is often convenient to further analyse these entries using the spreadsheet of your

+choice so the columns are tab separated to allow for easy conversion.

+

+The plugin can be included in a module using the following,

+

+<plugin>

+    <groupId>org.apache.tuscany.sca</groupId>

+    <artifactId>tuscany-maven-dependency-lister</artifactId>

+    <version>1.1-incubating-SNAPSHOT</version>

+    <executions>

+        <execution>

+            <goals>

+                <goal>execute</goal>

+            </goals>

+        </execution>

+    </executions>

+</plugin>  

+

+If you include this at the top level of you project and have it run for each model you

+will get a report for each model independently. For example, in the Tuscany SCA project

+the plugin is included in the pom.xml files at the sca level under the profile 

+"dependecies" so to generate a dependencies report for the Tuscany SCA project:

+

+cd sca

+mvn -o -Pdependencies -Dmaven.test.skip=true 

+

+Once you have dependency.txt files in your modules

+the you favourite command line tools can be used to concatenate and sort them

+to get a full picture of the dependencies in you project, for example, with linux you

+could do,

+

+find . -name dependency.txt -exec cat '{}' >> deptotal.txt \;