[MDEPLOY-247] - Version 3.0.0-M1 breaks deploy using alt*DeploymentRepository with old syntax on Windows

 - Enhanced docs

Author: khmarbaise

src/main/java/org/apache/maven/plugins/deploy/DeployMojo.java

@@ -101,7 +101,10 @@ public class DeployMojo
 
     /**
      * The alternative repository to use when the project has a snapshot version.
-     * 
+     *
+     * <b>Note:</b> In version 2, the format was <code>id::layout::url</code>, but since 3.0.0 the layout part has been
+     * removed because Maven 3 only supports <code>default</code> (ie. Maven 2) layout and not <code>legacy</code>
+     * (Maven 1) layout.</b>
      * @since 2.8
      * @see DeployMojo#altDeploymentRepository
      */
@@ -110,7 +113,10 @@ public class DeployMojo
 
     /**
      * The alternative repository to use when the project has a final version.
-     * 
+     *
+     * <b>Note:</b> In version 2, the format was <code>id::layout::url</code>, but since 3.0.0 the layout part has been
+     * removed because Maven 3 only supports <code>default</code> (ie. Maven 2) layout and not <code>legacy</code>
+     * (Maven 1) layout.</b>
      * @since 2.8
      * @see DeployMojo#altDeploymentRepository
      */

src/site/apt/index.apt.vm

@@ -80,7 +80,16 @@ ${project.name}
   Please note that the following parameter has been completely removed from the plugin configuration:
 
   * uniqueVersion
-  
+
+  * The syntax of the following parameters for the plugin has been changed:
+
+    * altDeploymentRepository
+    * altReleaseDeploymentRepository
+    * altSnapshotDeploymentRepository
+
+    The old format was: <<<id::layout::url>>>
+    The new format is:  <<<id::url>>>
+
   []
 
   As of Maven 3, snapshot artifacts will always be deployed using a timestamped version.