2005-01-23 03:54:48 +00:00

76 lines
2.5 KiB
XML

<?xml version="1.0"?>
<!--
/*
* Copyright 2001-2004 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-->
<document>
<properties>
<title>Maven Console</title>
<author email="dion@multitask.com.au">dIon Gillard</author>
</properties>
<body>
<section name="Maven Console">
<p>
This plugin provides an interactive environment for executing
Maven goals for a project. This cuts down on the JVM and Maven
start-up times allowing for lightning-fast repetitive execution
of Maven.
</p>
<p>
The console simply loads the current project.xml and waits for
the user to supply a goal (or set of comma-separated goals) to execute.
</p>
<source>clean,jar:jar</source>
<p>
You can press enter to re-run the last successful goal which is
displayed in the prompt.
</p>
<p>
To change a property on the fly, assign it like so:
</p>
<source>maven.test.skip=true</source>
<p>
To check the current value of a property, start the command with <code>=</code>:
</p>
<source>=maven.compile.source</source>
<p>
For more information on the functionality provided by this plugin,
please see the <a href="goals.html">Goals</a> document.
</p>
<p>
You can customize some features with
<a href="properties.html">properties</a>.
</p>
</section>
<section name="Improving the prompt">
<p>
It is possible to add completion and history to the console, however
it requires the use of an external library. This library is licensed
under the LPGL, and so cannot be used in the console by default, but
can be downloaded from <a href="http://jline.sf.net">JLine</a>.
</p>
<p>
Instructions are detailed in this
<a href="http://marc.theaimsgroup.com/?l=turbine-maven-user&amp;m=110568914709557&amp;w=2">mailing list post</a>.
</p>
</section>
</body>
</document>