From 554dec1a3eeafe0c1ff4bf7182904aefcae5f674 Mon Sep 17 00:00:00 2001
From: Stephane Nicoll <snicoll@pivotal.io>
Date: Fri, 29 Mar 2019 10:19:14 +0100
Subject: [PATCH] Document finalName alternative for repackage goal

Closes gh-16334
---
 .../site/apt/examples/repackage-name.apt.vm   | 42 +++++++++++++++++++
 .../src/site/apt/index.apt                    |  2 +
 .../src/site/site.xml                         |  1 +
 3 files changed, 45 insertions(+)
 create mode 100644 spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/examples/repackage-name.apt.vm

diff --git a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/examples/repackage-name.apt.vm b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/examples/repackage-name.apt.vm
new file mode 100644
index 0000000000..3dbd580c23
--- /dev/null
+++ b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/examples/repackage-name.apt.vm
@@ -0,0 +1,42 @@
+ -----
+ Repackage classifier
+ -----
+ Stephane Nicoll
+ -----
+ 2019-03-29
+ -----
+
+  If you need the repackage jar to have a different local name than the one defined by
+  the <<<artifactId>>> attribute of the project, simply use the standard <<<finalName>>>
+  as shown in the following example:
+
+---
+<project>
+  ...
+  <build>
+    <finalName>my-app</finalName>
+    <plugins>
+      ...
+      <plugin>
+        <groupId>${project.groupId}</groupId>
+        <artifactId>${project.artifactId}</artifactId>
+        <version>${project.version}</version>
+        <executions>
+          <execution>
+            <id>repackage</id>
+            <goals>
+              <goal>repackage</goal>
+            </goals>
+          </execution>
+        </executions>
+        ...
+      </plugin>
+      ...
+    </plugins>
+    ...
+  </build>
+  ...
+</project>
+---
+
+  This configuration will generate the repackaged artifact in <<<target/my-app.jar>>>.
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/index.apt b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/index.apt
index 2c0d71d3de..64cd7a049a 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/index.apt
+++ b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/apt/index.apt
@@ -46,6 +46,8 @@ Spring Boot Maven Plugin
 
   * {{{./examples/repackage-classifier.html}Custom repackage classifier}}
 
+  * {{{./examples/repackage-name.html}Custom repackage name}}
+
   * {{{./examples/repackage-disable-attach.html}Local repackaged artifact}}
 
   * {{{./examples/exclude-dependency.html}Exclude a dependency}}
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/site.xml b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/site.xml
index c393e2ceb6..6711b55c15 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/site.xml
+++ b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/site/site.xml
@@ -8,6 +8,7 @@
 		</menu>
 		<menu name="Examples">
 			<item name="Custom repackage classifier" href="examples/repackage-classifier.html"/>
+			<item name="Custom repackage name" href="examples/repackage-name.html"/>
 			<item name="Local repackaged artifact" href="examples/repackage-disable-attach.html"/>
 			<item name="Exclude a dependency" href="examples/exclude-dependency.html"/>
 			<item name="Debug the application" href="examples/run-debug.html"/>