You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2023/05/14 09:21:09 UTC

[maven-site] branch master updated: replace full copy/paste for 3.8.x and 4.x with slicker explanation against latest 3.9.x

This is an automated email from the ASF dual-hosted git repository.

hboutemy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git


The following commit(s) were added to refs/heads/master by this push:
     new de7eac28 replace full copy/paste for 3.8.x and 4.x with slicker explanation against latest 3.9.x
de7eac28 is described below

commit de7eac287d0490d1825b02d5ed2f81ab2793116a
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Sun May 14 11:21:00 2023 +0200

    replace full copy/paste for 3.8.x and 4.x with slicker explanation against latest 3.9.x
---
 content/xdoc/download.xml.vm | 172 +++++++++++++++----------------------------
 1 file changed, 60 insertions(+), 112 deletions(-)

diff --git a/content/xdoc/download.xml.vm b/content/xdoc/download.xml.vm
index 4d006673..b233579a 100644
--- a/content/xdoc/download.xml.vm
+++ b/content/xdoc/download.xml.vm
@@ -30,7 +30,7 @@ under the License.
   <body>
     <section name="Downloading Apache Maven ${currentStableVersion}">
 
-      <p>Apache Maven ${currentStableVersion} is the latest release and recommended version for all users.</p>
+      <p>Apache Maven ${currentStableVersion} is the latest release: it is the recommended version for all users.</p>
 
       <a name="Requirements"/>
       <subsection name="System Requirements" id="Requirements">
@@ -53,7 +53,7 @@ under the License.
             </tr>
             <tr>
               <td><b>Operating System</b></td>
-              <td>No minimum requirement. Start up scripts are included as shell scripts and Windows batch files.</td>
+              <td>No minimum requirement. Start up scripts are included as shell scripts (tested on many Unix flavors) and Windows batch files.</td>
             </tr>
           </table>
         </p>
@@ -107,22 +107,32 @@ under the License.
         </tbody>
       </table>
       <ul>
-        <li><a href="./docs/${currentStableVersion}/release-notes.html">Release Notes</a></li>
-        <li><a href="./ref/${currentStableVersion}/">Reference Documentation</a></li>
+        <li>${currentStableVersion} <a href="./docs/${currentStableVersion}/release-notes.html">Release Notes</a> and
+            <a href="./ref/${currentStableVersion}/">Release Reference Documentation</a></li>
+        <li><a href="./scm.html">latest source code from source repository</a></li>
+        <li>Distributed under the <a href="https://www.apache.org/licenses/">Apache License, version 2.0</a></li>
+        <li>other:<ul>
         <li><a href="./maven-site-1.0-site.jar">Apache Maven Website As Documentation Archive</a></li>
         <!-- not currently generated on the CMS due to the profile, probably also badly formattted
            <li>a <a href="./apache-maven.pdf">PDF file.</a></li>
         -->
         <li><a href="[preferred]maven/">All current release sources (plugins, shared libraries,...) available at https://downloads.apache.org/maven/</a></li>
-        <li><a href="./scm.html">latest source code from source repository</a></li>
-        <li>Distributed under the <a href="https://www.apache.org/licenses/">Apache License, version 2.0</a></li>
+        </ul></li>
       </ul>
       </subsection>
+
     </section>
-    <section name="Previous Stable 3.8.x Release">
-      <p>Apache Maven ${current38xVersion} is the previous stable minor release for all users.</p>
 
-      <subsection name="System Requirements" id="Requirements">
+    <section name="Other Releases">
+      <p>It is strongly recommended to use the latest release version of Apache Maven to take advantage of newest features and bug fixes.</p>
+      
+      <p>If you still want to use an old version, you can find more information in the
+      <a href="./docs/history.html">Maven Releases History</a> and can download files from 
+      the  <a href="https://archive.apache.org/dist/maven/maven-3/">Maven 3 archives</a> for versions 3.0.4+
+      and <a href="https://archive.apache.org/dist/maven/binaries/">legacy archives</a> for earlier releases.</p>
+
+      <subsection name="Previous Stable 3.8.x Release">
+        <p>Apache Maven ${current38xVersion} is the previous stable minor release for all users.</p>
         <p>
           <table>
             <tr>
@@ -130,25 +140,8 @@ under the License.
               <td>Maven 3.8+ requires JDK 1.7 or above to execute. It still allows you to build against 1.3 and other JDK versions
                   <a href="/guides/mini/guide-using-toolchains.html">by using toolchains</a>.</td>
             </tr>
-            <tr>
-              <td><b>Memory</b></td>
-              <td>No minimum requirement</td>
-            </tr>
-            <tr>
-              <td><b>Disk</b></td>
-              <td>Approximately 10MB is required for the Maven installation itself. In addition to that, disk space will
-                be used for your local Maven repository. The size of your local repository will vary depending on usage but expect at
-                least 500MB.</td>
-            </tr>
-            <tr>
-              <td><b>Operating System</b></td>
-              <td>No minimum requirement. Start up scripts are included as shell scripts and Windows batch files.</td>
-            </tr>
           </table>
         </p>
-      </subsection>
-
-      <subsection name="Files">
         <p>Maven is distributed in several formats for your convenience. Simply pick a
               ready-made binary distribution archive and follow the <a href="./install.html">
               installation instructions.</a>
@@ -161,62 +154,42 @@ under the License.
         <table>
           <thead>
             <tr>
-              <th></th>
-              <th>Link</th>
-              <th>Checksums</th>
-              <th>Signature</th>
+              <th>Format</th>
+              <th>Binary (Checksum, Signature)</th>
+              <th>Source (Checksum, Signature)</th>
             </tr>
           </thead>
           <tbody>
             <tr>
-              <td>Binary tar.gz archive</td>
-              <td><a href="[preferred]maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.tar.gz">apache-maven-${current38xVersion}-bin.tar.gz</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.tar.gz.sha512">apache-maven-${current38xVersion}-bin.tar.gz.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.tar.gz.asc">apache-maven-${current38xVersion}-bin.tar.gz.asc</a></td>
-            </tr>
-            <tr>
-              <td>Binary zip archive</td>
-              <td><a href="[preferred]maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.zip">apache-maven-${current38xVersion}-bin.zip</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.zip.sha512">apache-maven-${current38xVersion}-bin.zip.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.zip.asc">apache-maven-${current38xVersion}-bin.zip.asc</a></td>
+              <td>tar.gz archives</td>
+              <td>Binary <a href="[preferred]maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.tar.gz">apache-maven-${current38xVersion}-bin.tar.gz</a>
+                  (<a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.tar.gz.sha512">sha512</a>, 
+                   <a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.tar.gz.asc">asc</a>)</td>
+              <td>Source <a href="[preferred]maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-src.tar.gz">apache-maven-${current38xVersion}-src.tar.gz</a>
+                  (<a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-src.tar.gz.sha512">sha512</a>, 
+                   <a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-src.tar.gz.asc">asc</a>)</td>
             </tr>
             <tr>
-              <td>Source tar.gz archive</td>
-              <td><a href="[preferred]maven/maven-3/${current38xVersion}/source/apache-maven-${current38xVersion}-src.tar.gz">apache-maven-${current38xVersion}-src.tar.gz</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/source/apache-maven-${current38xVersion}-src.tar.gz.sha512">apache-maven-${current38xVersion}-src.tar.gz.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/source/apache-maven-${current38xVersion}-src.tar.gz.asc">apache-maven-${current38xVersion}-src.tar.gz.asc</a>
-              </td>
-            </tr>
-            <tr>
-              <td>Source zip archive </td>
-              <td><a href="[preferred]maven/maven-3/${current38xVersion}/source/apache-maven-${current38xVersion}-src.zip">apache-maven-${current38xVersion}-src.zip</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/source/apache-maven-${current38xVersion}-src.zip.sha512">apache-maven-${current38xVersion}-src.zip.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/source/apache-maven-${current38xVersion}-src.zip.asc">apache-maven-${current38xVersion}-src.zip.asc</a></td>
+              <td>zip archives</td>
+              <td>Binary <a href="[preferred]maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.zip">apache-maven-${current38xVersion}-bin.zip</a>
+                  (<a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.zip.sha512">sha512</a>,
+                   <a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-bin.zip.asc">asc</a>)</td>
+              <td>Source <a href="[preferred]maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-src.zip">apache-maven-${current38xVersion}-src.zip</a>
+                  (<a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-src.zip.sha512">sha512</a>,
+                   <a href="https://downloads.apache.org/maven/maven-3/${current38xVersion}/binaries/apache-maven-${current38xVersion}-src.zip.asc">asc</a>)</td>
             </tr>
           </tbody>
         </table>
         <ul>
-          <li><a href="./docs/${current38xVersion}/release-notes.html">Release Notes</a></li>
-          <li><a href="./ref/${current38xVersion}/">Reference Documentation</a></li>
-          <li><a href="[preferred]maven/">All current release sources (plugins, shared libraries,...) available at https://downloads.apache.org/maven/</a></li>
-          <li><a href="./scm.html">latest source code from source repository</a></li>
+          <li>${current38xVersion} <a href="./docs/${current38xVersion}/release-notes.html">Release Notes</a> and
+              <a href="./ref/${current38xVersion}/">Release Reference Documentation</a></li>
           <li>Distributed under the <a href="https://www.apache.org/licenses/">Apache License, version 2.0</a></li>
         </ul>
       </subsection>
 
-      <subsection name="Older Previous Releases">
-        <p>It is strongly recommended to use the latest release version of Apache Maven to take advantage of newest features and bug fixes.</p>
-        
-        <p>If you still want to use an old version you can find more information in the
-        <a href="./docs/history.html">Maven Releases History</a> and can download files from 
-        the  <a href="https://archive.apache.org/dist/maven/maven-3/">archives</a> for versions 3.0.4+
-        and <a href="https://archive.apache.org/dist/maven/binaries/">legacy archives</a> for earlier releases.</p>
-      </subsection>
-    </section>
-    <section name="Alpha 4.x Releases">
-      <p>Maven 4.x is currently under development, so while we are encouraging users to try it and report any issue, it is NOT safe for production use.</p>
+      <subsection name="Alpha 4.x Release">
+        <p>Maven 4.x is currently under development, so while we are encouraging users to try it and report any issue, it is NOT safe for production use.</p>
 
-      <subsection name="System Requirements" id="Requirements">
         <p>
           <table>
             <tr>
@@ -224,25 +197,9 @@ under the License.
               <td>Maven 4.0+ requires JDK 1.8 or above to execute. It still allows you to build against 1.3 and other JDK versions
                   <a href="/guides/mini/guide-using-toolchains.html">by using toolchains</a>.</td>
             </tr>
-            <tr>
-              <td><b>Memory</b></td>
-              <td>No minimum requirement</td>
-            </tr>
-            <tr>
-              <td><b>Disk</b></td>
-              <td>Approximately 10MB is required for the Maven installation itself. In addition to that, disk space will
-                be used for your local Maven repository. The size of your local repository will vary depending on usage but expect at
-                least 500MB.</td>
-            </tr>
-            <tr>
-              <td><b>Operating System</b></td>
-              <td>No minimum requirement. Start up scripts are included as shell scripts and Windows batch files.</td>
-            </tr>
           </table>
         </p>
-      </subsection>
 
-      <subsection name="Files">
         <p>Maven is distributed in several formats for your convenience. Simply pick a
               ready-made binary distribution archive and follow the <a href="./install.html">
               installation instructions.</a>
@@ -255,46 +212,37 @@ under the License.
         <table>
           <thead>
             <tr>
-              <th></th>
-              <th>Link</th>
-              <th>Checksums</th>
-              <th>Signature</th>
+              <th>Format</th>
+              <th>Binary (Checksum, Signature)</th>
+              <th>Source (Checksum, Signature)</th>
             </tr>
           </thead>
           <tbody>
             <tr>
-              <td>Binary tar.gz archive</td>
-              <td><a href="[preferred]maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.tar.gz">apache-maven-${current4xVersion}-bin.tar.gz</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.tar.gz.sha512">apache-maven-${current4xVersion}-bin.tar.gz.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.tar.gz.asc">apache-maven-${current4xVersion}-bin.tar.gz.asc</a></td>
-            </tr>
-            <tr>
-              <td>Binary zip archive</td>
-              <td><a href="[preferred]maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.zip">apache-maven-${current4xVersion}-bin.zip</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.zip.sha512">apache-maven-${current4xVersion}-bin.zip.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.zip.asc">apache-maven-${current4xVersion}-bin.zip.asc</a></td>
-            </tr>
-            <tr>
-              <td>Source tar.gz archive</td>
-              <td><a href="[preferred]maven/maven-4/${current4xVersion}/source/apache-maven-${current4xVersion}-src.tar.gz">apache-maven-${current4xVersion}-src.tar.gz</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/source/apache-maven-${current4xVersion}-src.tar.gz.sha512">apache-maven-${current4xVersion}-src.tar.gz.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/source/apache-maven-${current4xVersion}-src.tar.gz.asc">apache-maven-${current4xVersion}-src.tar.gz.asc</a>
-              </td>
+              <td>tar.gz archives</td>
+              <td>Binary <a href="[preferred]maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.tar.gz">apache-maven-${current4xVersion}-bin.tar.gz</a>
+                  (<a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.tar.gz.sha512">sha512</a>, 
+                   <a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.tar.gz.asc">asc</a>)</td>
+              <td>Source <a href="[preferred]maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-src.tar.gz">apache-maven-${current4xVersion}-src.tar.gz</a>
+                  (<a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-src.tar.gz.sha512">sha512</a>, 
+                   <a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-src.tar.gz.asc">asc</a>)</td>
             </tr>
             <tr>
-              <td>Source zip archive </td>
-              <td><a href="[preferred]maven/maven-4/${current4xVersion}/source/apache-maven-${current4xVersion}-src.zip">apache-maven-${current4xVersion}-src.zip</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/source/apache-maven-${current4xVersion}-src.zip.sha512">apache-maven-${current4xVersion}-src.zip.sha512</a></td>
-              <td><a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/source/apache-maven-${current4xVersion}-src.zip.asc">apache-maven-${current4xVersion}-src.zip.asc</a></td>
+              <td>zip archives</td>
+              <td>Binary <a href="[preferred]maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.zip">apache-maven-${current4xVersion}-bin.zip</a>
+                  (<a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.zip.sha512">sha512</a>,
+                   <a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-bin.zip.asc">asc</a>)</td>
+              <td>Source <a href="[preferred]maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-src.zip">apache-maven-${current4xVersion}-src.zip</a>
+                  (<a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-src.zip.sha512">sha512</a>,
+                   <a href="https://downloads.apache.org/maven/maven-4/${current4xVersion}/binaries/apache-maven-${current4xVersion}-src.zip.asc">asc</a>)</td>
             </tr>
           </tbody>
         </table>
         <ul>
-          <li><a href="./docs/${current4xVersion}/release-notes.html">Release Notes</a></li>
-          <li><a href="./ref/${current4xVersion}/">Reference Documentation</a></li>
-          <li><a href="[preferred]maven/">All current release sources (plugins, shared libraries,...) available at https://downloads.apache.org/maven/</a></li>
-          <li><a href="./scm.html">latest source code from source repository</a></li>
+          <li>${current4xVersion} <a href="./docs/${current4xVersion}/release-notes.html">Release Notes</a> and
+              <a href="./ref/${current4xVersion}/">Release Reference Documentation</a></li>
           <li>Distributed under the <a href="https://www.apache.org/licenses/">Apache License, version 2.0</a></li>
+          <li><a href="https://archive.apache.org/dist/maven/maven-4/">Maven 4 archives</a> for older 4.x releases.</li>
         </ul>
       </subsection>
     </section>