- Revision
- 1545
- Author
- mauro
- Date
- 2010-02-06 02:27:59 -0600 (Sat, 06 Feb 2010)
Log Message
JBEHAVE-236: Added building-source page.
Modified Paths
- trunk/core/distribution/src/site/content/sitemap.xml
- trunk/core/distribution/src/site/content/source-repository.html
Added Paths
Diff
Added: trunk/core/distribution/src/site/content/building-source.html (0 => 1545)
--- trunk/core/distribution/src/site/content/building-source.html (rev 0) +++ trunk/core/distribution/src/site/content/building-source.html 2010-02-06 08:27:59 UTC (rev 1545) @@ -0,0 +1,84 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html> +<head> +<title>Building Source</title> +</head> +<body> + +<h2>Overview</h2> + +<p>The following assumes basic familiarity with use of <a + href="" repository</a> and command-line +build systems.</p> + +<h2>Building with Maven</h2> + +<p><a href="" is a network-based +build management system. We assume the binary distribution has been +installed (version 2.2.x or above) and that the executable <b>mvn</b> is +in the system path.</p> +<p>People new to Maven may find useful to download a <a + href="" version of +the website documentation. There is also extensive free documentation +available from the <a href="" Maven Books</a>.</p> + +<h3>Maven build profiles</h3> + +<p>One of Maven's most useful features are <a + href="" + +<p>JBehave's profiles are:</p> + +<ul> + <li>default: builds all releasable modules</li> + <li>examples: builds examples</li> + <li>gui: builds examples that require non-headless mode + (separated as they do not run on <a + href="" + <li>reporting: builds reports</li> + <li>distribution: builds distribution</li> +</ul> + +<p>Note that profiles are additive and the default profile is always +active.</p> + +<p>Some examples:</p> + +<pre class="brush: plain"> +mvn clean install -Pexamples (build core and all examples, excluding GUI-based ones) +mvn clean install -Pexamples,gui (build core and all examples, including GUI-based ones) +mvn clean install -Preporting,distribution (build with reporting and distribution) +</pre> + +<p>Note that the Maven build phase <b>install</b> is used as it +automatically implies all other previous phases in the module <a + href="" +cycle</a>, in particular the <b>test</b> or <b>integration-test</b> phases, +where appropriate.</p> + +<h3>Performing a release</h3> + +<p>Using Maven's release plugin makes the release process very easy:</p> + +<pre class="brush: plain"> +mvn release:prepare -Preporting,distribution +mvn release:perform -Preporting,distribution +</pre> + +<p>It is a two-step process as the first step (<b>release:prepare</b>) +creates a tag in source control replacing all snapshot versions with a +fixed version, while the second step (<b>release:perform</b>) builds the +release from the tag and performs the upload to the remote repository.</p> + +<h2>Integration with IDEs</h2> + +<p>Maven is supported in most modern IDEs - e.g. <a + href="" +IDEA</a> or Eclipse (via the <a href="" +plugin</a>). It builds the project classpath based on the dependencies +declared in the POMs.</p> + +</body> + +</html>
Modified: trunk/core/distribution/src/site/content/sitemap.xml (1544 => 1545)
--- trunk/core/distribution/src/site/content/sitemap.xml 2010-02-06 08:11:15 UTC (rev 1544) +++ trunk/core/distribution/src/site/content/sitemap.xml 2010-02-06 08:27:59 UTC (rev 1545) @@ -9,6 +9,7 @@ <page>download.html</page> <page>javadoc.html</page> <page>release-notes.html</page> + <page>building-source.html</page> <page>running-examples.html</page> </section> <section>
Modified: trunk/core/distribution/src/site/content/source-repository.html (1544 => 1545)
--- trunk/core/distribution/src/site/content/source-repository.html 2010-02-06 08:11:15 UTC (rev 1544) +++ trunk/core/distribution/src/site/content/source-repository.html 2010-02-06 08:27:59 UTC (rev 1545) @@ -8,8 +8,7 @@ <h2>Overview</h2> -<p>This project uses a Source Content Management System to manage -its source code.</p> +<p>JBehave uses <a href="" to manage its source code.</p> <h2>Web Access</h2>
To unsubscribe from this list please visit:
