brett 2004/10/29 18:44:59
Modified: xdocs Tag: MAVEN-1_0-BRANCH changes.xml
xdocs/start Tag: MAVEN-1_0-BRANCH bootstrap.xml
Log:
PR: MAVEN-1355
Submitted by: Miguel Griffa
Reviewed by: Brett Porter
add documentation on building Maven with Maven (applied with some changes)
Revision Changes Path
No revision
No revision
1.14.4.40 +1 -0 maven/xdocs/changes.xml
Index: changes.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/changes.xml,v
retrieving revision 1.14.4.39
retrieving revision 1.14.4.40
diff -u -r1.14.4.39 -r1.14.4.40
--- changes.xml 28 Oct 2004 12:52:59 -0000 1.14.4.39
+++ changes.xml 30 Oct 2004 01:44:59 -0000 1.14.4.40
@@ -25,6 +25,7 @@
</properties>
<body>
<release version="1.0.1-SNAPSHOT" date="in CVS MAVEN-1_0-BRANCH">
+ <action dev="brett" type="fix" issue="MAVEN-1355" due-to="Miguel
Griffa">Document how to build Maven using Maven instead of bootstrapping</action>
<action dev="brett" type="fix" issue="MAVEN-1437">Specifically target the 1.3
JVM</action>
<action dev="brett" type="fix" issue="MAVEN-1363">Goals in maven:reactor and
maven:maven are trimmed</action>
<action dev="brett" type="fix" issue="MAVEN-1424" due-to="Felipe Leme">maven
-p now fails if file does not exist.</action>
No revision
No revision
1.13.4.5 +82 -8 maven/xdocs/start/bootstrap.xml
Index: bootstrap.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/start/bootstrap.xml,v
retrieving revision 1.13.4.4
retrieving revision 1.13.4.5
diff -u -r1.13.4.4 -r1.13.4.5
--- bootstrap.xml 7 Jun 2004 12:01:59 -0000 1.13.4.4
+++ bootstrap.xml 30 Oct 2004 01:44:59 -0000 1.13.4.5
@@ -129,21 +129,95 @@
<section name="Building the optional plugins">
<p>
- If you're building Maven 1.0-rc2 or later, the <strong>maven</strong> cvs
module
- will not contain all of the available plugins that are shipped with a
release.
- </p>
- <p>
- The source for the optional plugins can be found in the
<strong>maven-plugins</strong>
+ The source for the plugins can be found in the
<strong>maven-plugins</strong>
cvs repository. See the
- <a
href="http://maven.apache.org/reference/plugins/optional/cvs-usage.html";>documentation</a>
+ <a
href="http://maven.apache.org/reference/plugins/cvs-usage.html";>documentation</a>
for more information on accessing that repository.
</p>
<p>
- Once you've downloaded the source, you can easily install all the optional
plugins
+ Once you've downloaded the source, you can easily install all the plugins
in a single command. See the
- <a
href="http://maven.apache.org/reference/plugins/optional/faq.html#building-all";>FAQ</a>
+ <a
href="http://maven.apache.org/reference/plugins/faq.html#building-all";>FAQ</a>
for more detail on how to install them once downloaded.
</p>
+ </section>
+ <section name="Building Maven with Maven">
+ <p>
+ This section explains how to build Maven with an already installed Maven
binary.
+ This assumes that you have both the <code>maven</code> and
<code>maven-plugins</code>
+ CVS trees checked out, as above.
+ </p>
+ <p>
+ Start by running <code>maven -u</code> in the <code>maven</code> CVS tree's
base directory.
+ This will give you a quick overview of the defined goals.
+ </p>
+ <subsection name="Maven goals">
+ <p>
+ <strong>Note:</strong> some of the goals are named in the form of
plugins-x.
+ These goals have some common logic: they invoke the reactor on the
plugins
+ directory and use the properties maven.plugins.include and
maven.plugins.exclude.
+ </p>
+ <table>
+ <tr>
+ <th>Goal</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>maven:jar-install</td>
+ <td>
+ Compile Maven and put a new jar in ${maven.home}/lib.
+ This goal attains the jar:jar goal, and copies then the
+ jar to the lib in maven home, as well as to the local repository.
+ </td>
+ </tr>
+ <tr>
+ <td>maven:build-install</td>
+ <td>Builds a full, clean maven installation in the target/installer
directory.</td>
+ </tr>
+ <tr>
+ <td>maven:installer</td>
+ <td>
+ Builds and creates tar.gz, bzip, zip and exe (if NSIS is installed)
which are suitable for
+ binary installations, similar to the binaries that can be download
+ from the maven site.
+ </td>
+ </tr>
+ <tr>
+ <td>maven:plugins-build</td>
+ <td>
+ Build each Maven plugin into an installable jar. This goal runs the
+ clean and plugin target on the maven plugins dir. the included and
+ excluded plugins are contolled by the maven.plugins.include and
+ maven.plugins.excludes properties respectively.
+ </td>
+ </tr>
+ <tr>
+ <td>maven:plugins-clean</td>
+ <td>
+ Cleans all plugin projects. Runs the clean goal on the included
plugins.
+ </td>
+ </tr>
+ <tr>
+ <td>maven:plugins-install</td>
+ <td>
+ Install each Maven plugin. This goal runs the clean and
plugin:install goal
+ in each included plugin.
+ </td>
+ </tr>
+ <tr>
+ <td>maven:plugins-test</td>
+ <td>Test each Maven plugin. Runs the plugin:test goal on each included
plugin.</td>
+ </tr>
+ <tr>
+ <td>maven:run-touchstone</td>
+ <td>
+ Calls maven with the project file in
+ ${basedir}/src/test/touchstone-build/project.xml and the clean,
jar:jar and
+ touchstone-tests goals.
+ </td>
+ </tr>
+ </table>
+ </subsection>
</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
