You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/10/05 17:09:49 UTC
(maven-acr-plugin) branch master updated: Restore the headings Velocity drops and document the consumer extension
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-acr-plugin.git
The following commit(s) were added to refs/heads/master by this push:
new 4a96adf Restore the headings Velocity drops and document the consumer extension
4a96adf is described below
commit 4a96adf3670f19ddbf1c7d6559d9bc91d3d2f950
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Oct 5 18:12:32 2026 +0200
Restore the headings Velocity drops and document the consumer extension
In .md.vm pages a line starting with ## is a Velocity comment, so such
headings must stay wrapped in #[[ ]]#.
---
...-client-dependency.md => app-client-dependency.md.vm} | 16 ++++++++++++++--
src/site/markdown/index.md | 4 ++--
src/site/markdown/usage.md.vm | 2 +-
3 files changed, 17 insertions(+), 5 deletions(-)
diff --git a/src/site/markdown/examples/app-client-dependency.md b/src/site/markdown/examples/app-client-dependency.md.vm
similarity index 71%
rename from src/site/markdown/examples/app-client-dependency.md
rename to src/site/markdown/examples/app-client-dependency.md.vm
index f4800ff..40ad98a 100644
--- a/src/site/markdown/examples/app-client-dependency.md
+++ b/src/site/markdown/examples/app-client-dependency.md.vm
@@ -27,11 +27,12 @@ under the License.
# Using the app-client as a dependency
-Once the ACR Plugin has been used to generate an application client, the generated artifact can be used as a dependency by specifying the the `type` as `app-client`.
+Once the ACR Plugin has been used to generate an application client, the generated artifact can be used as a dependency by specifying the `type` as `app-client`.
-## Normal way of adding an Application Client dependency
+#[[## Normal way of adding an Application Client dependency]]#
The following dependency declaration would include the `application-client-project-1.0-SNAPSHOT.jar` in your project's package.
+The consuming project also has to load the ACR Plugin as an extension: Maven core does not define the `app-client` type, and without the plugin it looks for a file with an `.app-client` extension instead of `.jar`.
```xml
<project>
@@ -45,5 +46,16 @@ The following dependency declaration would include the `application-client-proje
</dependency>
</dependencies>
[...]
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-acr-plugin</artifactId>
+ <version>${project.version}</version>
+ <extensions>true</extensions>
+ </plugin>
+ </plugins>
+ </build>
+ [...]
</project>
```
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index e677087..f3b539a 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -26,7 +26,7 @@ under the License.
-->
# Apache Maven ACR Plugin
-This plugin generates J2EE Application Client file.
+This plugin builds a Jakarta EE application client JAR.
## Goals Overview
@@ -38,7 +38,7 @@ General instructions on how to use the ACR Plugin can be found on the [usage pag
In case you still have questions regarding the plugin's usage, feel free to contact the [user mailing list](./mailing-lists.html). The posts to the mailing list are archived and could already contain the answer to your question as part of an older thread. Hence, it is also worth browsing/searching the [mail archive](./mailing-lists.html).
-If you feel like the plugin is missing a feature or has a defect, you can fill a feature request or bug report in our [issue tracker](./issue-management.html). When creating a new issue, please provide a comprehensive description of your concern. Especially for fixing bugs it is crucial that the developers can reproduce your problem. For this reason, entire debug logs, POMs or most preferably little demo projects attached to the issue are very much appreciated. Of course, patches are wel [...]
+If you feel like the plugin is missing a feature or has a defect, you can file a feature request or bug report in our [issue tracker](./issue-management.html). When creating a new issue, please provide a comprehensive description of your concern. Especially for fixing bugs it is crucial that the developers can reproduce your problem. For this reason, entire debug logs, POMs or most preferably little demo projects attached to the issue are very much appreciated. Of course, patches are wel [...]
## Examples
diff --git a/src/site/markdown/usage.md.vm b/src/site/markdown/usage.md.vm
index a92cec9..4c077d5 100644
--- a/src/site/markdown/usage.md.vm
+++ b/src/site/markdown/usage.md.vm
@@ -58,7 +58,7 @@ The ACR Plugin is used to package a JavaEE Application Client module. There are
mvn acr:acr
```
-## Manifest entries
+#[[## Manifest entries]]#
The plugin does not invent a default `Main-Class`. If you do not set
`archive.manifest.mainClass` (and you do not supply a custom manifest that