From 9de7d764ab8f1a52b174e969ba4adf6950d52944 Mon Sep 17 00:00:00 2001
From: Markus Wiik <markus.wiik@gmail.com>
Date: Tue, 7 Jan 2025 18:06:25 +0100
Subject: [PATCH] Fix #386

---
 docs/maven.md | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/docs/maven.md b/docs/maven.md
index 3d35e92ba..dfe565323 100644
--- a/docs/maven.md
+++ b/docs/maven.md
@@ -9,7 +9,7 @@ the plugin to your POM like this
       <plugin>
         <artifactId>jdeb</artifactId>
         <groupId>org.vafer</groupId>
-        <version>1.11</version>
+        <version>1.12</version>
         <executions>
           <execution>
             <phase>package</phase>
@@ -47,7 +47,7 @@ Or if you want to build a custom deb file
       <extension>
         <groupId>org.vafer</groupId>
         <artifactId>jdeb</artifactId>
-        <version>1.11</version>
+        <version>1.12</version>
       </extension>
     </extensions>
     <pluginManagement>
@@ -97,13 +97,16 @@ also be injected. If a changes file is used, the `Distribution` usually comes
 from that file. The default changes file is called `CHANGES.txt`. See below
 for the syntax of the content of the changes file.
 
-Property replacement will also occur in any of the standard debian control
-files: conffiles, preinst, postinst, prerm, postrm. This allows dynamic
-configuration of the form:
+Property replacement will also occur in the final filename, and any of the
+standard debian control files: conffiles, preinst, postinst, prerm, postrm.
+This allows dynamic configuration of the form:
 
     /etc/[[artifactId]]/[[artifactId]].properties
     /etc/[[artifactId]]/log4j.xml
 
+Possible substitutions are `[[baseDir]]`, `[[buildDir]]`, `[[artifactId]]`,
+`[[version]]`, `[[extension]]` and `[[groupId]]`.
+
 If you now do a `mvn clean install`, the `deb` goal will be called and
 artifacts consisting of the deb and potentially the changes file will
 automatically be attached to the project.
@@ -115,7 +118,7 @@ section with any of the following options:
 
 Element          | Description                                                                                | Required
 ---------------- | ------------------------------------------------------------------------------------------ | -----------------------------------------------------------------
-deb              | The debian package to be generated                                                         | No; defaults to `${buildDirectory}/${artifactId}_${version}_all.deb`
+deb              | The debian package to be generated                                                         | No; defaults to `[[buildDir]]/[[artifactId]]_[[version]]_all.[[extension]]`
 type             | Artifact type                                                                              | No; defaults to `deb`
 classifier       | Artifact classifier                                                                        | No; defaults to ''
 controlDir       | The directory containing the control files                                                 | No; defaults to `src/deb/control`
@@ -188,7 +191,7 @@ include a directory, a tarball, and a file in your deb package and then sign it
       <plugin>
         <artifactId>jdeb</artifactId>
         <groupId>org.vafer</groupId>
-        <version>1.11</version>
+        <version>1.12</version>
         <executions>
           <execution>
             <phase>package</phase>