Update documentation

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@113369 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
evenisse committed 2003-04-22 12:20:49 +00:00
1 parent 87a37f82e8
commit b4b57f369b
8 files changed
+15 -411

No files matched your search

+4 -35
View File
@@ -5,6 +5,7 @@
<title>Maven Java Plug-in Goals</title>
<author email="dion@multitask.com.au">dIon Gillard</author>
<author email="kschrader@karmalab.org">Kurt Schrader</author>
<author email="evenisse@ifrance.com">Emmanuel Venisse</author>
</properties>
<body>
@@ -12,43 +13,11 @@
<table>
<tr><th>Goal</th><th>Description</th></tr>
<tr>
<td>java:prepare-filesystem</td>
<td>
Creates the directories necessary for compilation
</td>
<td>jar:jar</td>
<td>Launch jar:jar goal.</td>
</tr>
<tr>
<td>java:compile</td>
<td>
<p>
Compiles the Java source code for the project
</p>
<p>
The source code directory is specified in the
<a href="http://maven.apache.org/reference/project-descriptor.html#build">build</a>
element of your <code>project.xml</code>
file.
</p>
</td>
</tr>
<tr>
<td>java:jar-resources</td>
<td>
<p>
Copies any resources that must be present in the deployed JAR
file, from the directory specified by
<a href="properties.html">maven.jarResources.basedir</a> to the
build directory, where class files are stored.
</p>
<p>
The <a href="properties.html">maven.jar.resources.set</a>
property is used to determine which files from the base directory
are included
</p>
</td>
</tr>
<tr>
<td>java:jar</td>
<td>jar:jar</td>
<td>
Creates a jar file in the Maven build directory with the
form <code>${project.id}-${project.currentVersion}.jar</code> where
+4 -3
View File
@@ -2,14 +2,15 @@
<document>
<properties>
<title>Maven Java Plug-in</title>
<title>Maven Jar Plug-in</title>
<author email="jason@zenplex.com">Jason van Zyl</author>
<author email="evenisse@ifrance.com">Emmanuel Venisse</author>
</properties>
<body>
<section name="Maven Java Plug-in">
<section name="Maven Jar Plug-in">
<p>
This plug-in provides your basic Javac and Jar facilities.
This plug-in provides your basic Jar facilities.
</p>
<p>
For more information on the functionality provided by this plugin,
+3 -3
View File
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="Maven Java Plugin">
<project name="Maven Jar Plugin">
<title>Maven Java Plugin</title>
<title>Maven Jar Plugin</title>
<body>
<links>
@@ -10,7 +10,7 @@
</links>
<menu name="Overview">
<item name="Goals" href="/goals.html" />
<item name="Properties" href="/properties.html" />
<item name="Properties" href="/properties.html" />
</menu>
</body>
</project>
+1 -174
View File
@@ -8,179 +8,6 @@
</properties>
<body>
<section name="Compile Settings">
<table>
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
<tr>
<td>maven.compile.aspects</td>
<td>Yes</td>
<td>
Specifies that Aspects are included during compilation.
Used by the "java:compile" goal.
The default value is <code>false</code>. Please
refer to the <a href="http://www.aspectj.org/">AspectJ</a>
web site for more information on Aspect-Oriented
Programming.
</td>
</tr>
<tr>
<td>maven.compile.compilerargs</td>
<td>Yes</td>
<td>
<p>
Provides arguments to a compiler when <code>maven.compile.fork</code>
is set to true
</p>
<p>
Corresponds to the nested <code>compilerarg</code> element for the ant
<a href="http://ant.apache.org/manual/CoreTasks/javac.html">javac</a>
task.
</p>
</td>
</tr>
<tr>
<td>maven.compile.debug</td>
<td>Yes</td>
<td>
Specifies wether to include debugging information in the compiled
class files; the default value is <code>on</code>.
Used by the "java:compile" goal.
</td>
</tr>
<tr>
<td>maven.compile.deprecation</td>
<td>Yes</td>
<td>
Specifies wether source should be compiled with deprecation
information; the default value is <code>off</code>.
Used by the "java:compile" goal.
</td>
</tr>
<tr>
<td>maven.compile.encoding</td>
<td>Yes</td>
<td>
<p>
Sets the encoding of the .java files being compiled
</p>
<p>
Corresponds to the <code>encoding</code> attribute for the ant
<a href="http://ant.apache.org/manual/CoreTasks/javac.html">javac</a>
task.
</p>
</td>
</tr>
<tr>
<td>maven.compile.executable</td>
<td>Yes</td>
<td>
<p>
Names the program to be invoked as the java compiler
</p>
<p>
Corresponds to the <code>executable</code> attribute for the ant
<a href="http://ant.apache.org/manual/CoreTasks/javac.html">javac</a>
task.
</p>
</td>
</tr>
<tr>
<td>maven.compile.fork</td>
<td>Yes</td>
<td>
<p>
Runs the compiler in a separate process
</p>
<p>
Corresponds to the <code>fork</code> attribute for the ant
<a href="http://ant.apache.org/manual/CoreTasks/javac.html">javac</a>
task.
</p>
</td>
</tr>
<tr>
<td>maven.compile.optimize</td>
<td>Yes</td>
<td>
Specifies whether source should be compiled with optimization; the
default value is <code>off</code>.
Used by the "java:compile" goal.
</td>
</tr>
<tr>
<td>maven.compile.source</td>
<td>Yes</td>
<td>
<p>
Provide source compatibility with a specific release
</p>
<p>
Corresponds to the <code>source</code> attribute for the ant
<a href="http://ant.apache.org/manual/CoreTasks/javac.html">javac</a>
task.
</p>
</td>
</tr>
<tr>
<td>maven.compile.src.set</td>
<td>Yes</td>
<td>
The source directories maven uses to compile java code.
</td>
</tr>
<tr>
<td>maven.compile.target</td>
<td>Yes</td>
<td>
<p>
Generate class files for a specific JVM version
</p>
<p>
Corresponds to the <code>target</code> attribute for the ant
<a href="http://ant.apache.org/manual/CoreTasks/javac.html">javac</a>
task.
</p>
</td>
</tr>
<tr>
<td>maven.compile.verbose</td>
<td>Yes</td>
<td>
<p>
Asks the compiler for verbose output
</p>
<p>
Corresponds to the <code>verbose</code> attribute for the ant
<a href="http://ant.apache.org/manual/CoreTasks/javac.html">javac</a>
task.
</p>
</td>
</tr>
<tr>
<td>pom.build.sourceModifications</td>
<td>Yes</td>
<td>
This property is the list of the
<source><![CDATA[
<build>
<sourceModification>
<sourceModification>
<className></className>
<excludes>
<exclude></exclude>
</excludes>
</sourceModification>
</sourceModification>
</build>
]]></source>
source modifications in your
<a href="http://maven.apache.org/reference/project-descriptor.html">
project descriptor</a>. This property is used during compilation to exclude or
include classes from compilation depending on whether a named class is available
</td>
</tr>
</table>
</section>
<section name="Jar Settings">
<table>
<tr>
@@ -316,7 +143,7 @@
<td>maven.build.dir</td>
<td>Yes</td>
<td>
Used by the <code>java:jar</code> goal for
Used by the <code>jar:jar</code> goal for
<ul>
<li>a temporary manifest file, if one is not specified</li>
<li>the assembled jar file</li>
+1 -60
View File
@@ -50,66 +50,7 @@
<tr>
<td>java:jar</td>
<td>
Creates a jar file in the Maven build directory with the
form <code>${project.id}-${project.currentVersion}.jar</code> where
the id and currentVersion are taken from the <code>project.xml</code>
of the project being built.
</td>
</tr>
<tr>
<td>jar:snapshot</td>
<td>
Creates a jar file in the Maven build directory with the
form <code>${project.id}-YYYYMMDD.hhmmss.jar</code> where
<ul>
<li>
id - taken from the <code>project.xml</code>
of the project being built
</li>
<li>YYYYMMDD - The current year in 8 digit format</li>
<li>hhmmss - the current time in 6 digit format</li>
</ul>
</td>
</tr>
<tr>
<td>jar:deploy-snapshot</td>
<td>
Deploy a snapshot jar to the remote repository
</td>
</tr>
<tr>
<td>jar:deploy</td>
<td>
Deploy a jar to the remote repository. The jar is built using
the <code>java:jar</code> goal
</td>
</tr>
<tr>
<td>jar:install</td>
<td>
Install a jar into the local repository. The jar is built using
the <code>java:jar</code> goal
</td>
</tr>
<tr>
<td>jar:install-snapshot</td>
<td>
Install a jar into the local repository. The jar is built using
the <code>jar:snapshot</code> goal and copied into the local
repository as the -SNAPSHOT version.
</td>
</tr>
<tr>
<td>clean</td>
<td>
This goal is a shortcut to the <code>clean:clean</code> goal
</td>
</tr>
<tr>
<td>clean:clean</td>
<td>
Removes the <a href="properties.html">maven.build.dir</a> and
<a href="properties.html">maven.test.reportsDirectory</a> directories
Deprecated. You must use jar:jar goal.
</td>
</tr>
</table>
+1 -1
View File
@@ -9,7 +9,7 @@
<body>
<section name="Maven Java Plug-in">
<p>
This plug-in provides your basic Javac and Jar facilities.
This plug-in provides your basic Javac facilities.
</p>
<p>
For more information on the functionality provided by this plugin,
+1 -1
View File
@@ -10,7 +10,7 @@
</links>
<menu name="Overview">
<item name="Goals" href="/goals.html" />
<item name="Properties" href="/properties.html" />
<item name="Properties" href="/properties.html" />
</menu>
</body>
</project>
-134
View File
@@ -181,113 +181,6 @@
</tr>
</table>
</section>
<section name="Jar Settings">
<table>
<tr>
<td>maven.has.jar.resource.patterns</td>
<td>Yes</td>
<td>
This is a calculated property based on the value of the
<source><![CDATA[
<build>
<resources>
</resources>
</build>
]]></source>
section of your
<a href="http://maven.apache.org/reference/project-descriptor.html">
project descriptor</a>. If there are <code>includes</code> or <code>excludes</code>
elements, this property will be set to true
</td>
</tr>
<tr>
<td>maven.jar.excludes</td>
<td>Yes</td>
<td>
Specifies a list of patterns to exclude from the jar process.
The default value is <code>**/package.html</code>, and is used
by the "java:jar" goal.
</td>
</tr>
<tr>
<td>maven.jar.manifest</td>
<td>Yes</td>
<td>
Specifies the manifest to be used in the creation of a jar.
This file is 'merged' with the default manifest created by
Maven. Any values specified in the file referenced by this
property will override Maven's defaults.
</td>
</tr>
<tr>
<td>maven.jar.mainclass</td>
<td>Yes</td>
<td>
Specifies the Main-Class attribute for your manifest. If not set,
no MainClass attribute will be added to the manifest.
</td>
</tr>
<tr>
<td>maven.jarResources.basedir</td>
<td>Yes</td>
<td>
The base directory from which resources to be included in a jar can be found.
Defaults to the base directory of the project.
</td>
</tr>
<tr>
<td>maven.jar.resources.set</td>
<td>Yes</td>
<td>
This is the Ant <code>patternset</code> of all the <code>include</code>s and
<code>exclude</code>s from the
<source><![CDATA[
<build>
<resources>
</resources>
</build>
]]></source>
section of your
<a href="http://maven.apache.org/reference/project-descriptor.html">
project descriptor</a>
</td>
</tr>
</table>
</section>
<section name="Deploy Settings">
<table>
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
<tr>
<td>maven.repo.central</td>
<td>Yes</td>
<td>
Central repository for maven artifacts
</td>
</tr>
<tr>
<td>maven.repo.central.directory</td>
<td>Yes</td>
<td>
Directory to deploy jars into on the remote repository
</td>
</tr>
<tr>
<td>maven.repo.local</td>
<td>Yes</td>
<td>
The local repository to store maven artifacts, including jar file
dependencies
</td>
</tr>
<tr>
<td>maven.username</td>
<td>Yes</td>
<td>
This is the user name used to log in to the remote repository
</td>
</tr>
</table>
</section>
<section name="Other Settings">
<table>
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
@@ -296,17 +189,6 @@
<td>Yes</td>
<td>The directory for compiled classes</td>
</tr>
<tr>
<td>maven.build.dir</td>
<td>Yes</td>
<td>
Used by the <code>java:jar</code> goal for
<ul>
<li>a temporary manifest file, if one is not specified</li>
<li>the assembled jar file</li>
</ul>
</td>
</tr>
<tr>
<td>maven.dependency.classpath</td>
<td>Yes</td>
@@ -317,22 +199,6 @@
project descriptor</a>
</td>
</tr>
<tr>
<td>maven.final.name</td>
<td>Yes</td>
<td>
Usually this property is set to <code>${project.id}-${project.currentVersion}</code>
but the snapshot goal overwrites it to be the snapshot signature
</td>
</tr>
<tr>
<td>user.name</td>
<td>Yes</td>
<td>
Used by the <code>java:jar</code> goal as the default value of the
<code>Built-By</code> attribute of the manifest if one is not specified.
</td>
</tr>
</table>
</section>
</body>