blob: 4767b36e08369e10f1054221908f7fe0f38101bf [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
~ Licensed to the Apache Software Foundation (ASF) under one
~ or more contributor license agreements. See the NOTICE file
~ distributed with this work for additional information
~ regarding copyright ownership. The ASF licenses this file
~ to you 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>Apache Maven Resource Bundles</title>
<author>Olivier Lamy</author>
</properties>
<body>
<section name="Apache Maven Resource Bundles">
<p>This project a set of resources to help you building Java resources compliant with Apache rules.</p>
<section name="Text Materials">
<p>
To generate in your jar:
<ul>
<li><code>META-INF/DEPENDENCIES</code></li>
<li><code>META-INF/LICENSE</code></li>
<li><code>META-INF/NOTICE</code></li>
</ul>
<source><![CDATA[ <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-remote-resources-plugin</artifactId>
<version>1.3</version>
<executions>
<execution>
<goals>
<goal>process</goal>
</goals>
<configuration>
<resourceBundles>
<!-- Will generate META-INF/DEPENDENCIES META-INF/LICENSE META-INF/NOTICE -->
<resourceBundle>org.apache:apache-jar-resource-bundle:${apache-jar-resource-bundle-version}</resourceBundle>
<!-- Will generate META-INF/DEPENDENCIES.txt META-INF/LICENSE.txt META-INF/NOTICE.txt -->
<resourceBundle>org.apache.apache.resources:apache-jar-txt-resource-bundle:${apache-jar-txt-resource-bundle-version}</resourceBundle>
<!-- Will generate META-INF/DISCLAIMER -->
<resourceBundle>org.apache.apache.resources:apache-incubator-disclaimer-resource-bundle:${apache-incubator-disclaimer-resource-bundle-version}</resourceBundle>
</resourceBundles>
</configuration>
</execution>
</executions>
</plugin>]]></source>
</p>
</section>
<section name="Source Assembly Descriptor">
<p>Create a source-release artifact that contains the fully buildable project directory source structure.
This is the artifact which is the official subject of any release vote.
<source><![CDATA[ <plugin>
<artifactId>maven-assembly-plugin</artifactId>
<dependencies>
<dependency>
<groupId>org.apache.apache.resources</groupId>
<artifactId>apache-source-release-assembly-descriptor</artifactId>
<version>${apache-source-release-assembly-descriptor-version}</version>
</dependency>
</dependencies>
<executions>
<execution>
<id>source-release-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
<configuration>
<!--
use this flag to generate source release assembly from the top of a multi modules
maven project.
<runOnlyAtExecutionRoot>true</runOnlyAtExecutionRoot>
-->
<descriptorRefs>
<descriptorRef>source-release</descriptorRef>
</descriptorRefs>
<tarLongFileMode>gnu</tarLongFileMode>
</configuration>
</execution>
</executions>
</plugin>]]></source>
</p>
</section>
</section>
</body>
</document>