Prep for bug fix release

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@113894 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
dion 2003-08-29 01:55:46 +00:00
parent 00abfd709c
commit a7dc04c706
14 changed files with 715 additions and 2 deletions

19
jar/announcements/1.1.ann Normal file
View File

@ -0,0 +1,19 @@
The Maven team is pleased to announce the Jar plugin 1.1 release!
http://maven.apache.org/reference/plugins/jar/index.html
The Maven Jar plugin is a core plugin of Maven that assists in creating jar files.
This release is a bug fix release to allow users of Maven 1.0-beta10 to update their local
installation. The default for creating a jar index is now false.
Changes in this version:
o Added maven.jar.index property
o Upgrade to velocity 1.4-dev
You can download the Jar plugin here:
http://www.ibiblio.org/maven/maven/plugins/maven-jar-plugin-1.1.jar
Have fun!
-dIon

View File

@ -5,7 +5,7 @@
<pomVersion>3</pomVersion>
<id>maven-jar-plugin</id>
<name>Maven Jar Plug-in</name>
<currentVersion>1.1-SNAPSHOT</currentVersion>
<currentVersion>1.1</currentVersion>
<description/>
<shortDescription>Java Project Management Tools</shortDescription>
<url>http://maven.apache.org/reference/plugins/jar/</url>

View File

@ -8,7 +8,7 @@
<body>
<release version="1.1" date="in CVS">
<release version="1.1" date="2003-08-29">
<action dev="dion" type="update">
Added maven.jar.index property
</action>

View File

@ -0,0 +1,27 @@
<?xml version="1.0"?>
<document>
<properties>
<title>Changes</title>
<author email="evenisse@ifrance.com">Emmanuel Venisse</author>
<author email="dion@apache.org">dIon Gillard</author>
</properties>
<body>
<release version="1.1" date="2003-08-29">
<action dev="dion" type="update">
Added maven.jar.index property
</action>
<action dev="dion" type="update">
Upgrade to velocity 1.4-dev
</action>
</release>
<release version="1.0" date="Unknown">
<action dev="evenisse" type="add">
Initial plugin created. Goals are move from java plugin.
</action>
</release>
</body>
</document>

View File

@ -0,0 +1,87 @@
<?xml version="1.0"?>
<document>
<properties>
<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>
<section name="Goals">
<table>
<tr><th>Goal</th><th>Description</th></tr>
<tr>
<td>jar:jar</td>
<td>Launch jar:jar goal.</td>
</tr>
<tr>
<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
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
</td>
</tr>
</table>
</section>
</body>
</document>

View File

@ -0,0 +1,26 @@
<?xml version="1.0"?>
<document>
<properties>
<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 Jar Plug-in">
<p>
This plug-in provides your basic Jar facilities.
</p>
<p>
For more information on the functionality provided by this plugin,
please see the <a href="goals.html">Goals</a> document.
</p>
<p>
For more information on how to customise the functionality provided
by this plugin, please see the <a href="properties.html">properties</a>
document.
</p>
</section>
</body>
</document>

View File

@ -0,0 +1,190 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document>
<properties>
<title>Properties</title>
<author email="smor@apache.org">Stéphane MOR</author>
<author email="dion@multitask.com.au">dIon Gillard</author>
</properties>
<body>
<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.index</td>
<td>Yes</td>
<td>
Whether to create an index list to speed up classloading.
This is a JDK 1.3+ specific feature. Defaults to false.
</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.manifest.extensions.add</td>
<td>Yes</td>
<td>
Tells maven to add extension information the the jar manifest.
This can cause some applications to break, so it has been disabled by default.
Set to 'true' to enable extension information.
</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>
<tr>
<td>maven.remote.group</td>
<td>Yes</td>
<td>
The name of the Unix group that should own deployed artifacts. Default to maven
</td>
</tr>
</table>
</section>
<section name="Other Settings">
<table>
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
<tr>
<td>maven.build.dest</td>
<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>jar: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>
<td>
This property holds the Ant <code>path</code> of all the dependent jar
files listed in the <code>dependencies</code> block of your
<a href="http://maven.apache.org/reference/project-descriptor.html">
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>
</document>

View File

@ -12,5 +12,22 @@
<item name="Goals" href="/goals.html" />
<item name="Properties" href="/properties.html" />
</menu>
<menu name="Versions">
<item name="Current" href="current/index.html" collapse="true">
<item name="Goals" href="/current/goals.html" />
<item name="Properties" href="/current/properties.html" />
<item name="Changes" href="/current/changes.html" />
</item>
<item name="Release 1.1" href="/releases/v1.1/index.html">
<item name="Goals" href="/releases/v1.1/goals.html" />
<item name="Properties" href="/releases/v1.1/properties.html" />
<item name="Changes" href="/releases/v1.1/changes.html" />
</item>
</menu>
<menu name="Downloads">
<item name="Jar Plugin 1.1"
href="http://www.ibiblio.org/maven/maven/plugins/maven-jar-plugin-1.1.jar"/>
</menu>
</body>
</project>

View File

@ -0,0 +1 @@
stylesheets

View File

@ -0,0 +1,27 @@
<?xml version="1.0"?>
<document>
<properties>
<title>Changes</title>
<author email="evenisse@ifrance.com">Emmanuel Venisse</author>
<author email="dion@apache.org">dIon Gillard</author>
</properties>
<body>
<release version="1.1" date="2003-08-29">
<action dev="dion" type="update">
Added maven.jar.index property
</action>
<action dev="dion" type="update">
Upgrade to velocity 1.4-dev
</action>
</release>
<release version="1.0" date="Unknown">
<action dev="evenisse" type="add">
Initial plugin created. Goals are move from java plugin.
</action>
</release>
</body>
</document>

View File

@ -0,0 +1,87 @@
<?xml version="1.0"?>
<document>
<properties>
<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>
<section name="Goals">
<table>
<tr><th>Goal</th><th>Description</th></tr>
<tr>
<td>jar:jar</td>
<td>Launch jar:jar goal.</td>
</tr>
<tr>
<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
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
</td>
</tr>
</table>
</section>
</body>
</document>

View File

@ -0,0 +1,26 @@
<?xml version="1.0"?>
<document>
<properties>
<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 Jar Plug-in">
<p>
This plug-in provides your basic Jar facilities.
</p>
<p>
For more information on the functionality provided by this plugin,
please see the <a href="goals.html">Goals</a> document.
</p>
<p>
For more information on how to customise the functionality provided
by this plugin, please see the <a href="properties.html">properties</a>
document.
</p>
</section>
</body>
</document>

View File

@ -0,0 +1,16 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="Maven Jar Plugin">
<title>Maven Jar Plugin</title>
<body>
<links>
<item name="Maven" href="http://maven.apache.org/"/>
<item name="Java" href="http://java.sun.com/"/>
</links>
<menu name="Overview">
<item name="Goals" href="/goals.html" />
<item name="Properties" href="/properties.html" />
</menu>
</body>
</project>

View File

@ -0,0 +1,190 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document>
<properties>
<title>Properties</title>
<author email="smor@apache.org">Stéphane MOR</author>
<author email="dion@multitask.com.au">dIon Gillard</author>
</properties>
<body>
<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.index</td>
<td>Yes</td>
<td>
Whether to create an index list to speed up classloading.
This is a JDK 1.3+ specific feature. Defaults to false.
</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.manifest.extensions.add</td>
<td>Yes</td>
<td>
Tells maven to add extension information the the jar manifest.
This can cause some applications to break, so it has been disabled by default.
Set to 'true' to enable extension information.
</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>
<tr>
<td>maven.remote.group</td>
<td>Yes</td>
<td>
The name of the Unix group that should own deployed artifacts. Default to maven
</td>
</tr>
</table>
</section>
<section name="Other Settings">
<table>
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
<tr>
<td>maven.build.dest</td>
<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>jar: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>
<td>
This property holds the Ant <code>path</code> of all the dependent jar
files listed in the <code>dependencies</code> block of your
<a href="http://maven.apache.org/reference/project-descriptor.html">
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>
</document>