You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by jv...@apache.org on 2005/10/12 22:56:36 UTC
svn commit: r315044 - in
/maven/components/trunk/maven-site/src/site/apt/guides/mini:
guide-coping-with-sun-jars.apt guide-maven-classloading.apt
guide-using-extensions.apt
Author: jvanzyl
Date: Wed Oct 12 13:56:32 2005
New Revision: 315044
URL: http://svn.apache.org/viewcvs?rev=315044&view=rev
Log:
o updating the SUN JAR guide
Modified:
maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt
maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-maven-classloading.apt
maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-using-extensions.apt
Modified: maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt
URL: http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt?rev=315044&r1=315043&r2=315044&view=diff
==============================================================================
--- maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt (original)
+++ maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt Wed Oct 12 13:56:32 2005
@@ -58,7 +58,16 @@
When you add a Sun dependency to your POM if you use the our suggestions
as noted above then Maven 2.x can help you locate the JARs by providing
the site where they can be retrieved. It is important that you follow
- the suggested naming conventions as even though we cannot store the
- JARs at Ibiblio we can store metadata about those JARs and it is the
- metadata that contains location and retrieval information.
+ the suggested naming conventions as we cannot store the JARs at Ibiblio we
+ can store metadata about those JARs and it is the metadata that contains
+ location and retrieval information.
+ Once you have downloaded a particular SUN JAR to your system you can install the JAR
+ in your local repository using a the install plug-in:
+
++----+
+
+m2 install:install-file -Dfile=<path-to-file> -DgroupId=<group-id> \
+ -DartifactId=<artifact-id> -Dversion=<version> -Dpackaging=<packaging>
+
++----+
Modified: maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-maven-classloading.apt
URL: http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-maven-classloading.apt?rev=315044&r1=315043&r2=315044&view=diff
==============================================================================
--- maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-maven-classloading.apt (original)
+++ maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-maven-classloading.apt Wed Oct 12 13:56:32 2005
@@ -6,27 +6,34 @@
12 October 2005
------
-How maven's classloaders work
+How Maven's classloaders work
- To add a bit of detail for a volunteer to submit as documentation... :)
++----+
- m2/core/boot is what is in the java classpath (ie, just classworlds,
- which constructs classloaders for the rest of the system)
+main is org.apache.maven.cli.MavenCli from plexus.core.maven
- the top level classloader contains plexus container and plexus utils
- (see m2/core), and also has access to classworlds
-
- the next classloader has the libraries in m2/lib (a bug in beta 1
- incorporated commons-logging and -lang, sorry about that!) In general
- these are just maven libraries. We hope to further separate these in
- future to just be maven apis.
-
- after that, each plugin has its own classloader, including its
- dependencies, itself, and the libraries above. It *does not* contain
- the project dependencies like in m1, but instead has access to a list
- of JAR files in case they are needed.
-
- In addition, a project can list "extensions". These are loaded into
- the same place as m2/lib and so available to the maven core and all
- plugins for the currnet project and subsequent projects (in future, we
- plan to remove it from subsequent projects).
+set maven.home default ${user.home}/m2
+
+[plexus.core]
+load ${maven.home}/core/*.jar
+
+[plexus.core.maven]
+load ${maven.home}/lib/*.jar
+
++----+
+
+ m2/core/boot is what is in the java classpath (ie, just classworlds, which constructs classloaders for the
+ rest of the system)
+
+ the top level classloader contains plexus container and plexus utils (see m2/core), and also has access to classworlds
+
+ the next classloader has the libraries in m2/lib In general these are just maven libraries. We hope to further
+ separate these in future to just be maven apis.
+
+ after that, each plugin has its own classloader, including its dependencies, itself, and the libraries above.
+ It *does not* contain the project dependencies like in m1, but instead has access to a list of JAR files in case
+ they are needed.
+
+ In addition, a project can list "extensions". These are loaded into the same place as m2/lib and so available to
+ the maven core and all plugins for the currnet project and subsequent projects (in future, we plan to remove it
+ from subsequent projects).
Modified: maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-using-extensions.apt
URL: http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-using-extensions.apt?rev=315044&r1=315043&r2=315044&view=diff
==============================================================================
--- maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-using-extensions.apt (original)
+++ maven/components/trunk/maven-site/src/site/apt/guides/mini/guide-using-extensions.apt Wed Oct 12 13:56:32 2005
@@ -8,10 +8,49 @@
Using Extensions
- * Maven Wagon Providers
- * Maven SCM Providers
- * Plug-ins that define their own lifecycle
-
- When creating your own lifecycles:
- This is a missing instruction on the build lifecycle page. You need to
- add the plugin to the project, <extensions>true</extensions>
+ Extensions are used to enable Wagon providers, used for the transport of artifact between repositories, and plug-ins
+ which provide lifecycle enhancements.
+
+* Wagon providers
+
++----+
+
+<project>
+ ...
+ <build>
+ <extensions>
+ <extension>
+ <groupId>org.apache.maven.wagon</groupId>
+ <artifactId>wagon-ftp</artifactId>
+ <version>1.0-alpha-3</version>
+ </extension>
+ </extensions>
+ </build>
+ ...
+</project>
+
++----+
+
+* Plug-ins which provide lifecycle enhancements
+
++----+
+
+<project>
+ ...
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.codehaus.plexus</groupId>
+ <artifactId>plexus-maven-plugin</artifactId>
+ <version>1.1-alpha-8-SNAPSHOT</version>
+ <extensions>true</extensions>
+ <configuration>
+ ...
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ ...
+</project>
+
++----+