diff --git a/jar/xdocs/goals.xml b/jar/xdocs/goals.xml
index 6d81ffa0..ec361710 100644
--- a/jar/xdocs/goals.xml
+++ b/jar/xdocs/goals.xml
@@ -63,6 +63,8 @@
           <td>jar:deploy-snapshot</td>
           <td>
             Deploy a snapshot jar to the remote repository.
+            <strong>DEPRECATED</strong>: use <code>jar:deploy</code> with
+            <code>-SNAPSHOT</code> in the project version for equivalent behaviour.
           </td>
         </tr>
         <tr>
@@ -85,6 +87,8 @@
             Install a snapshot into the local repository. The jar is built using
             the <code>jar:jar</code> goal and copied into the local
             repository as the -SNAPSHOT version.
+            <strong>DEPRECATED</strong>: use <code>jar:install</code> with
+            <code>-SNAPSHOT</code> in the project version for equivalent behaviour.
           </td>
         </tr>
       </table>