svn commit: r190215 - /maven/components/trunk/maven-site/src/site/apt/building.apt

[br...@apache.org]

Author: brett
Date: Sat Jun 11 21:51:48 2005
New Revision: 190215

URL: http://svn.apache.org/viewcvs?rev=190215&view=rev
Log:
add building doc

Added:
    maven/components/trunk/maven-site/src/site/apt/building.apt

Added: maven/components/trunk/maven-site/src/site/apt/building.apt
URL: http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/apt/building.apt?rev=190215&view=auto
==============================================================================
--- maven/components/trunk/maven-site/src/site/apt/building.apt (added)
+++ maven/components/trunk/maven-site/src/site/apt/building.apt Sat Jun 11 21:51:48 2005
@@ -0,0 +1,74 @@
+ ------
+ Building Maven 2.0
+ ------
+ Brett Porter
+ ------
+ 12 June 2005
+ ------
+
+Building Maven 2.0
+
+* Why would I want to build Maven 2.0?
+
+  Building Maven 2.0 yourself is for one of two reasons:
+
+    * to try out a bleeding edge feature or bugfix
+
+    * to fix a problem you are having and submit a patch to the developers team.
+
+  Note, that you don't need to bootstrap Maven for day to day use, or to develop plugins. While we encourage getting
+  involved and fixing bugs that you find, for day to day use we recommend using the latest release.
+
+* Checking out the sources
+
+  All of the source code for Maven 2.0 and its related libraries are in Subversion. You can
+  {{{http://svn.apache.org/viewcvs.cgi/maven/} browse the repository}}, or checkout specific modules directly.
+
+  To build Maven 2.0, you need the <<<components>>> module. To check that out, run the command:
+
+-------------------
+svn co http://svn.apache.org/repos/asf/maven/components/trunk maven-components
+-------------------
+
+  The <<<maven-components>>> directory will contain the source code. Note that this contains all of the plugins and
+  the Ant tasks.
+
+  Other modules you might be interested in related to Maven development are:
+
+    * <<<wagon/trunk>>> - Maven Wagon, used by the artifact code and others for providing the transport layer to
+      get and put artifacts in a repository.
+
+    * <<<scm/trunk>>> - Maven SCM, a generic API to communicate with various different SCM providers, used by
+      Continuum and the release and SCM plugins.
+
+    * {{{http://svn.plexus.codehaus.org/plexus/} Plexus}} - the IoC container used by Maven.
+
+* Building Maven
+
+  Once you have checked out the code, change into the <<<maven-components>>> directory that was created.
+  You may want to setup a different environment to install Maven to other than your normal installation of a
+  release, so set the <<<M2_HOME>>> environment variable accordingly, e.g.:
+
+----
+export M2_HOME=/usr/local/maven-2.0-SNAPSHOT
+PATH=$M2_HOME/bin:$PATH
+  or
+set M2_HOME=c:\maven-2.0-SNAPSHOT
+set PATH=%M2_HOME%\bin;$PATH
+----
+
+  From this, run the <<<m2-bootstrap-all>>> command for your system:
+
+----
+sh m2-bootstrap-all.sh
+  or
+m2-bootstrap-all.bat
+----
+
+  First, the code will be built, then using the new installation the plugins will be rebuilt and installed in the
+  local repository. Finally, a set of integration tests will run.
+
+  If you have any problems or get any failures during the run, please report them to the 
+  {{{/mail-lists.html} Maven Developers List}}.
+
+



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org