[maven-release] 01/01: [MRELEASE-955] add POM snippet

[hb...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

hboutemy pushed a commit to branch MRELEASE-955
in repository https://gitbox.apache.org/repos/asf/maven-release.git

commit ed1a065099eabdcba10a04c9966b27a1d0406752
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Fri May 6 07:03:36 2022 +0200

    [MRELEASE-955] add POM snippet
---
 .../src/site/apt/{upgrade.apt => upgrade.apt.vm}   | 40 ++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/maven-release-plugin/src/site/apt/upgrade.apt b/maven-release-plugin/src/site/apt/upgrade.apt.vm
similarity index 74%
rename from maven-release-plugin/src/site/apt/upgrade.apt
rename to maven-release-plugin/src/site/apt/upgrade.apt.vm
index adbfe070..93f66930 100644
--- a/maven-release-plugin/src/site/apt/upgrade.apt
+++ b/maven-release-plugin/src/site/apt/upgrade.apt.vm
@@ -50,6 +50,46 @@ Upgrading Maven Release Plugin From 2 to 3
     {{{https://central.sonatype.org/publish/publish-maven/}the documentation}}
 
    []
+
+  Then configure <<<maven-release-plugin>>> to use that profile during <<<release:perform>>> with <<<releaseProfiles>>> parameter:
+
++-------+
+<project>
+  [...]
+  <build>
+    [...]
+    <plugins>
+      [...]
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-release-plugin</artifactId>
+        <version>${project.version}</version>
+        <configuration>
+          <releaseProfiles>my-project-release</releaseProfiles>
+        </configuration>
+      </plugin>
+      [...]
+    </plugins>
+    [...]
+  </build>
+
+  [...]
+
+  <profiles>
+    <profile>
+      <id>my-project-release</id>
+      <build>
+        <plugins>
+         [...
+          put here your release-specific plugins invocations, like maven-source-plugin, maven-javadoc-plugin, maven-gpg-plugin, ...
+          ...]
+        </plugins>
+      </build>
+    </profile>
+    [...]
+  </profiles>
+</project>
++-------+
  
 ** Short Term: Force Using Maven 3-only Default Release Profile