[MASSEMBLY-824] Use of appendAssemblyId and finalName can cause problems

Updated documentation to clarify that setting 'appendAssemblyId' to 'false' also removes the classifier and can lead to warnings about changing the file of the main project artifact.

git-svn-id: https://svn.apache.org/repos/asf/maven/plugins/trunk@1754566 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/maven/plugins/assembly/mojos/AbstractAssemblyMojo.java b/src/main/java/org/apache/maven/plugins/assembly/mojos/AbstractAssemblyMojo.java
index 06253d1..2ed5c8d 100644
--- a/src/main/java/org/apache/maven/plugins/assembly/mojos/AbstractAssemblyMojo.java
+++ b/src/main/java/org/apache/maven/plugins/assembly/mojos/AbstractAssemblyMojo.java
@@ -72,7 +72,9 @@
     protected FixedStringSearchInterpolator rootInterpolator;
 
     /**
-     * Set to false to exclude the assembly id from the assembly final name.
+     * Set to false to exclude the assembly id from the assembly final name, and to create the resultant assembly
+     * artifacts without classifier. As such, an assembly artifact having the same format as the packaging of the
+     * current Maven project will replace the file for this main project artifact.
      */
     @Parameter( property = "assembly.appendAssemblyId", defaultValue = "true" )
     boolean appendAssemblyId;