Modified: maven/website/content/guides/plugins/validation/index.html ============================================================================== --- maven/website/content/guides/plugins/validation/index.html (original) +++ maven/website/content/guides/plugins/validation/index.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/guides/plugins/validation/index.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/guides/plugins/validation/index.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Plugin Validation</title> <link rel="stylesheet" href="../../../css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="../../../css/site.css" /> <link rel="stylesheet" href="../../../css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="../../.././" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="../../.././" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/guides/plugins/validation/index.md"><img src="../../../images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Plugin Validation <a href="https://github.com/apache/maven-site/tree/master/content/markdown/guides/plugins/validation/index.md"><img src="../../../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="../../../scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="../../../download.cgi" title="Download">Download</a></li> @@ -144,7 +141,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Plugin_Validation"></a> +<section> <h1>Plugin Validation</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -169,9 +166,10 @@ in order to help Maven users and Maven P use or maintain that may break in the future.</p> <p>These issues are displayed as WARNING either when plugin goal is executed or at the end of the build:</p> +<div class="verbatim"> <pre><code>[WARNING] Plugin validation issues were detected in x plugin(s) -</code></pre> -<p>and split in two categories based on what actions should be taken:</p><section><a id="Internal_issues"></a> +</code></pre></div> +<p>and split in two categories based on what actions should be taken:</p><section> <h2>Internal issues</h2> <p>Internal Plugins Validation issues (project local) are issues discovered in Maven project configuration, like:</p> <ul> @@ -181,7 +179,7 @@ use or maintain that may break in the fu <li>project using read only plugin parameters (<a href="https://issues.apache.org/jira/browse/MNG-7464" class="externalLink">MNG-7464</a>).</li> </ul> <p>In such cases, users can fix their project by fixing configuration by editing their POMs. -Users should consult actual plugin documentation (and eventually try to update plugin to newer version).</p></section><section><a id="External_issues"></a> +Users should consult actual plugin documentation (and eventually try to update plugin to newer version).</p></section><section> <h2>External issues</h2> <p>External Plugins Validation issues (non-configuration) are issues detected in plugin itself, like:</p> <ul> @@ -191,14 +189,15 @@ Users should consult actual plugin docum </ul> <p>External Plugins issues require to be fixed by plugin authors first.</p> <p>In such cases users can try to update plugin to newer version. -If the newest version of plugin still has such an issue, users should report problem to plugin authors.</p></section><section><a id="Exclude_plugins_from_validation"></a> +If the newest version of plugin still has such an issue, users should report problem to plugin authors.</p></section><section> <h2>Exclude plugins from validation</h2> <p>In some case we know about issues in some plugin and we want exclude it from validation. We can do it by property <code>maven.plugin.validation.excludes</code>, eg:</p> +<div class="verbatim"> <pre><code>mvn -Dmaven.plugin.validation.excludes=plugin1-goupId:plugin1-artifactId:plugin1-version,plugin2-goupId:plugin2-artifactId:plugin2-version -</code></pre> -<p>Property <code>maven.plugin.validation</code> has tha same rule as <code>maven.plugin.validation</code> - can only be used on command line (not as property in POM)</p></section><section><a id="Manage_Plugin_Validation_verbosity"></a> +</code></pre></div> +<p>Property <code>maven.plugin.validation</code> has tha same rule as <code>maven.plugin.validation</code> - can only be used on command line (not as property in POM)</p></section><section> <h2>Manage Plugin Validation verbosity</h2> <p>In order to manage Plugin Validation verbosity, a Maven user property <code>-Dmaven.plugin.validation=...</code> can be used on command line (or injected: see below).</p> <p>Allowed values are:</p> @@ -212,8 +211,9 @@ We can do it by property <code>maven.plu </ul> <p>Configuration values for <code>maven.plugin.validation</code> are case insensitive, can only be used on command line (not as property in POM), like:</p> +<div class="verbatim"> <pre><code>mvn -Dmaven.plugin.validation=verbose ... -</code></pre> +</code></pre></div> <p>As a consequence:</p> <ul>
Modified: maven/website/content/ide.html ============================================================================== --- maven/website/content/ide.html (original) +++ maven/website/content/ide.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/ide.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/ide.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Apache Maven IDE Integration</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/ide.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Apache Maven IDE Integration <a href="https://github.com/apache/maven-site/tree/master/content/markdown/ide.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -136,7 +133,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Apache_Maven_IDE_Integration"></a> +<section> <h1>Apache Maven IDE Integration</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -156,11 +153,11 @@ specific language governing permissions under the License. --> -<p>All popular development environments for the Java platform support Apache Maven.</p><section><a id="Apache_NetBeans_IDE"></a> +<p>All popular development environments for the Java platform support Apache Maven.</p><section> <h2>Apache NetBeans IDE</h2> <p>Apache NetBeans has included full Maven support since version 6.7. You can open any Maven project in the IDE and start coding immediately.</p> -<p>For more information see the <a href="http://wiki.netbeans.org/Maven" class="externalLink">NetBeans.org wiki page</a>.</p></section><section><a id="Eclipse_IDE_-_M2Eclipse"></a> +<p>For more information see the <a href="http://wiki.netbeans.org/Maven" class="externalLink">NetBeans.org wiki page</a>.</p></section><section> <h2>Eclipse IDE - M2Eclipse</h2> <p><a href="https://www.eclipse.org/m2e/" class="externalLink">M2Eclipse</a> is the official Eclipse project for Maven integration for the Eclipse IDE.</p> @@ -178,7 +175,7 @@ the official Eclipse project for Maven i </ul> <p>M2E dynamically integrates with your Maven projects with Eclipse while you make changes in the IDE. As you change dependencies, or configurations of Maven plugins in your POMs M2E, will synchronize the -Eclipse workspace with those changes.</p></section><section><a id="JetBrains_IntelliJ_IDEA"></a> +Eclipse workspace with those changes.</p></section><section> <h2>JetBrains IntelliJ IDEA</h2> <p>IntelliJ IDEA has a <a href="https://www.jetbrains.com/idea/help/maven.html" class="externalLink">feature-rich integration for Maven</a>.</p></section></section> </main> Modified: maven/website/content/index.html ============================================================================== --- maven/website/content/index.html (original) +++ maven/website/content/index.html Sun May 12 07:42:36 2024 @@ -2,18 +2,18 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/xdoc/index.xml.vm at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/xdoc/index.xml.vm at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <meta name="author" content="Brett Porter" /> <meta name="author" content="Jason van Zyl" /> <meta name="author" content="Olivier Lamy" /> - <title>Maven</title> + <title>Maven â Welcome to Apache Maven</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -40,10 +40,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -51,9 +49,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/xdoc/index.xml.vm"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Welcome to Apache Maven <a href="https://github.com/apache/maven-site/tree/master/content/xdoc/index.xml.vm"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -135,7 +132,7 @@ - <section><a id="Welcome_to_Apache_Maven"></a> + <section> <h1>Welcome to Apache Maven</h1> @@ -234,7 +231,7 @@ If you are looking for a quick reference, you can use the <a href="guides/index.html">documentation index</a>. </p> - <section><a id="How_to_Get_Support"></a><section><a id="How_to_Get_Support"></a> + <section><section> <h3>How to Get Support</h3> <p> @@ -258,7 +255,7 @@ You can also reach the Maven developers on <a href="community.html">Slack</a>. </p> - + </section><section> <h3>Apache Software Foundation</h3> <p> Modified: maven/website/content/install.html ============================================================================== --- maven/website/content/install.html (original) +++ maven/website/content/install.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/install.md.vm at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/install.md.vm at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Installing Apache Maven</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/install.md.vm"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Installing Apache Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/install.md.vm"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -136,7 +133,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Installing_Apache_Maven"></a> +<section> <h1>Installing Apache Maven</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -167,12 +164,14 @@ and adding the <code>bin</code> director <p>Extract distribution archive in any directory</p></li> </ul> +<div class="verbatim"> <pre><code class="language-cmd">unzip apache-maven-3.9.6-bin.zip -</code></pre> +</code></pre></div> <p>or</p> +<div class="verbatim"> <pre><code class="language-sh">tar xzvf apache-maven-3.9.6-bin.tar.gz -</code></pre> +</code></pre></div> <p>Alternatively use your preferred archive extraction tool.</p> <ul> @@ -183,13 +182,14 @@ the <code>PATH</code> environment variab <p>Confirm with <code>mvn -v</code> in a new shell. The result should look similar to</p></li> </ul> +<div class="verbatim"> <pre><code>Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae) Maven home: /opt/apache-maven-3.9.6 Java version: 1.8.0_45, vendor: Oracle Corporation Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home/jre Default locale: en_US, platform encoding: UTF-8 OS name: "mac os x", version: "10.8.5", arch: "x86_64", family: "mac" -</code></pre></section> +</code></pre></div></section> </main> </div> </div> Modified: maven/website/content/issue-management.html ============================================================================== --- maven/website/content/issue-management.html (original) +++ maven/website/content/issue-management.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/issue-management.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/issue-management.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Overview</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/issue-management.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Overview <a href="https://github.com/apache/maven-site/tree/master/content/markdown/issue-management.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -129,7 +126,52 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section> +<section><section> +<h2>Overview</h2><!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +<p>Maven projects use <a href="https://www.atlassian.com/software/jira" class="externalLink">Jira</a> as issue tracking and project management application.</p></section><section> +<h2>Issue Management</h2> +<p>Maven is composed of nearly <a href="/scm.html#Maven_Sources_Overview">100 parts</a>, each one having its own Jira project or component: +<strong>see the <a href="https://cwiki.apache.org/confluence/display/MAVEN/Maven+JIRA+issues+overview" class="externalLink">Maven Jira issues overview</a> to get a summary of open issues</strong>.</p> +<p>Issues, bugs, and feature requests should be submitted to the following +issue management systems depending on which component is involved:</p> +<ul> + +<li> +<p>Maven “core”: <a href="https://issues.apache.org/jira/browse/MNG" class="externalLink">https://issues.apache.org/jira/browse/MNG</a></p></li> +<li> +<p>Maven Website: <a href="https://issues.apache.org/jira/browse/MNGSITE" class="externalLink">https://issues.apache.org/jira/browse/MNGSITE</a></p></li> +<li> +<p>Maven Plugins: Please refer to the <a href="./plugins/index.html">Available Plugins</a> page</p></li> +<li> +<p>Maven Shared Components: Please refer to the <a href="./shared/index.html">Shared Components</a> page</p></li> +<li> +<p>Doxia: <a href="https://issues.apache.org/jira/browse/DOXIA" class="externalLink">https://issues.apache.org/jira/browse/DOXIA</a></p></li> +<li> +<p>JXR: <a href="https://issues.apache.org/jira/browse/JXR" class="externalLink">https://issues.apache.org/jira/browse/JXR</a></p></li> +<li> +<p>SCM: <a href="https://issues.apache.org/jira/browse/SCM" class="externalLink">https://issues.apache.org/jira/browse/SCM</a></p></li> +<li> +<p>Wagon: <a href="https://issues.apache.org/jira/browse/WAGON" class="externalLink">https://issues.apache.org/jira/browse/WAGON</a></p></li> +</ul> +<p>or for Central Repository: <a href="https://issues.sonatype.org/browse/MVNCENTRAL" class="externalLink">https://issues.sonatype.org/browse/MVNCENTRAL</a></p></section></section> </main> </div> </div> Modified: maven/website/content/mailing-lists.html ============================================================================== --- maven/website/content/mailing-lists.html (original) +++ maven/website/content/mailing-lists.html Sun May 12 07:42:36 2024 @@ -2,14 +2,14 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.5.0:mailing-lists at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.5.0:mailing-lists at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <title>Maven â Project Mailing Lists</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -49,7 +47,7 @@ <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> <li class="active ">Project Mailing Lists</li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> Modified: maven/website/content/maven-1.x-eol.html ============================================================================== --- maven/website/content/maven-1.x-eol.html (original) +++ maven/website/content/maven-1.x-eol.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-1.x-eol.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-1.x-eol.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â End Of Life Apache Maven 1.x</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-1.x-eol.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">End Of Life Apache Maven 1.x <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-1.x-eol.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -129,7 +126,43 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section> +<section><section> +<h2>End Of Life Apache Maven 1.x</h2><!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +<p>The Apache Maven Project Team would like to inform you that the Apache +Maven 1.x has reached its end of life and is no longer supported.</p> +<p>Apache Maven 1.x had its last release - version 1.1 - in June 2007.</p> +<p>This means:</p> +<ul> + +<li>security vulnerability reports will not be checked against the 1.x +branch</li> +<li>the 1.x download pages will be removed.</li> +<li>the latest 1.x release will be removed from the mirror system</li> +<li>the 1.x branch in svn will move from /maven/maven-1/ to +/maven/archives/maven-1/</li> +<li>the links to the 1.x documentation will be moved from +<a href="https://maven.apache.org/maven-1.x/" class="externalLink">https://maven.apache.org/maven-1.x/</a> to +<a href="https://maven.apache.org/archives/maven-1.x/" class="externalLink">https://maven.apache.org/archives/maven-1.x/</a></li> +</ul> +<p>The Apache Maven Team.</p></section></section> </main> </div> </div> Modified: maven/website/content/maven-2.x-eol.html ============================================================================== --- maven/website/content/maven-2.x-eol.html (original) +++ maven/website/content/maven-2.x-eol.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-2.x-eol.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-2.x-eol.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â End Of Life Apache Maven 2.x</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-2.x-eol.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">End Of Life Apache Maven 2.x <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-2.x-eol.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -129,7 +126,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="End_Of_Life_Apache_Maven_2.x"></a> +<section> <h1>End Of Life Apache Maven 2.x</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -158,7 +155,7 @@ under the License. <li>the 2.x download pages will be removed</li> <li>the latest 2.x release will be removed from the mirror system</li> <li>the links to any 2.x specific documentation will be moved to <a href="https://maven.apache.org/archives/maven-2.x/" class="externalLink">Maven 2.x Archives</a></li> -</ul><section><a id="List_Of_Last_Plugins_Versions_Which_Support_Maven_2.x"></a> +</ul><section> <h2>List Of Last Plugins Versions Which Support Maven 2.x</h2> <p>This list contains the list of plugins with the last version that supports Maven 2.x, which means if you have to use Maven 2, this list is Modified: maven/website/content/maven-ci-friendly.html ============================================================================== --- maven/website/content/maven-ci-friendly.html (original) +++ maven/website/content/maven-ci-friendly.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-ci-friendly.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-ci-friendly.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Maven CI Friendly Versions</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-ci-friendly.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Maven CI Friendly Versions <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-ci-friendly.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -129,7 +126,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Maven_CI_Friendly_Versions"></a> +<section> <h1>Maven CI Friendly Versions</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -150,10 +147,11 @@ under the License. --> <p>Starting with Maven 3.5.0-beta-1 you can use the <code>${revision}</code>, <code>${sha1}</code> -and/or <code>${changelist}</code> as placeholders for the version in your pom file.</p><section><a id="Single_Project_Setup"></a> +and/or <code>${changelist}</code> as placeholders for the version in your pom file.</p><section> <h2>Single Project Setup</h2> <p>This can look like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -167,22 +165,25 @@ and/or <code>${changelist}</code> as pla <version>${revision}</version> ... </project> -</code></pre> +</code></pre></div> <p>This is of course a simple situation where we use only <code>${revision}</code> for brevity to show the general course.</p> <p>Based on the above pom you can build your project using:</p> +<div class="verbatim"> <pre><code>mvn clean package -</code></pre> +</code></pre></div> <p>But wait there is a problem? Which version will the artifacts have? So you need to define the version for your artifacts. The first possibility is to use the command line like this:</p> +<div class="verbatim"> <pre><code>mvn -Drevision=1.0.0-SNAPSHOT clean package -</code></pre> +</code></pre></div> <p>This will become cumbersome over the time. So the other solution for this is to simply use a property inside the pom file which looks like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -199,17 +200,19 @@ to simply use a property inside the pom <revision>1.0.0-SNAPSHOT</revision> </properties> </project> -</code></pre> +</code></pre></div> <p>So now you can simply call Maven as usual like <code>mvn clean package</code>.</p> <p>You can of course change the version via the command line like this:</p> +<div class="verbatim"> <pre><code>mvn -Drevision=2.0.0-SNAPSHOT clean package -</code></pre> +</code></pre></div> <p>Of course you can use the <code>.mvn/maven.config</code> file for this.</p> <p>A note about the used properties. You can only use those named <code>${revision}</code>, <code>${sha1}</code> and/or <code>${changelist}</code> and not other named properties like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -226,11 +229,12 @@ named properties like this:</p> <revision>1.0.0-${buildNumber}-SNAPSHOT</revision> </properties> </project> -</code></pre> +</code></pre></div> <p>The above example will <em>not work as expected</em>. If you like to have more flexibility you can use a combination of the different properties like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -249,27 +253,31 @@ different properties like this:</p> <sha1/> </properties> </project> -</code></pre> +</code></pre></div> <p>If you like to make a version <code>2.0.0-SNAPSHOT</code> this can simply being achieved by using this:</p> +<div class="verbatim"> <pre><code>mvn -Drevision=2.0.0 clean package -</code></pre> +</code></pre></div> <p>Another usage example can be to make a release which can be done via (version 1.3.1):</p> +<div class="verbatim"> <pre><code>mvn -Dchangelist= clean package -</code></pre> +</code></pre></div> <p>Or if you like to make a release with another version:</p> +<div class="verbatim"> <pre><code>mvn -Drevision=2.7.8 -Dchangelist= clean package -</code></pre> -<p>Please read until the end of this documentation!</p></section><section><a id="Multi_Module_Setup"></a> +</code></pre></div> +<p>Please read until the end of this documentation!</p></section><section> <h2>Multi Module Setup</h2> <p>So now let us take a look into a situation where we have a multi module build. We have a parent pom and one or more children. The parent pom will look like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -290,9 +298,10 @@ The parent pom will look like this:</p> .. </modules> </project> -</code></pre> +</code></pre></div> <p>The child will look like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -304,15 +313,16 @@ The parent pom will look like this:</p> <artifactId>ci-child</artifactId> ... </project> -</code></pre> +</code></pre></div> <p>A multi module build can of course build the same way as the single project setup. You should -define the version either via property in the parent or use the <code>.mvn/maven.config</code> file.</p></section><section><a id="Dependencies"></a> +define the version either via property in the parent or use the <code>.mvn/maven.config</code> file.</p></section><section> <h2>Dependencies</h2> <p>In a multi module build you have often the case that you define dependencies between module(s). The usual way of defining dependencies and their appropriate versions has been to use <code>${project.version}</code> and this has not been changed.</p> <p>So the correct way to do such things can be seen in the following example:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -333,9 +343,10 @@ versions has been to use <code>${project .. </modules> </project> -</code></pre> +</code></pre></div> <p>The child will look like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -354,15 +365,16 @@ versions has been to use <code>${project </dependency> </dependencies> </project> -</code></pre> +</code></pre></div> <p>If you try to use <code>${revision}</code> instead of <code>${project.version}</code> your build -will fail.</p></section><section><a id="Install_.2F_Deploy"></a> +will fail.</p></section><section> <h2>Install / Deploy</h2> <p>If you like to install or deploy artifacts by using the above setup you <strong>have to use</strong> the <a href="https://www.mojohaus.org/flatten-maven-plugin/" class="externalLink">flatten-maven-plugin</a> otherwise you will install/deploy artifacts in your repository which will not be consumable by Maven anymore. Such kind of setup will look like this:</p> +<div class="verbatim"> <pre><code class="language-xml"><project> <modelVersion>4.0.0</modelVersion> <parent> @@ -413,7 +425,7 @@ will look like this:</p> .. </modules> </project> -</code></pre></section></section> +</code></pre></div></section></section> </main> </div> </div> Modified: maven/website/content/maven-conventions.html ============================================================================== --- maven/website/content/maven-conventions.html (original) +++ maven/website/content/maven-conventions.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-conventions.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-conventions.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Maven Conventions</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-conventions.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Maven Conventions <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-conventions.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -129,7 +126,66 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section> +<section><section> +<h2>Maven Conventions</h2><!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +<p>This document defines some conventions that Maven recommends projects +adopt. This is especially important if you intend to distribute your +project publicly.</p></section><section> +<h2>Artifact Naming</h2> +<p>This section outlines the naming conventions used in the Maven project +object model (POM). This document is an attempt to try and unify the +many various ways projects name the artifacts that they publish for +general consumption by the Java developer community (regardless of +whether they are using Maven).</p> +<p>The first thing you will do when creating a project is to select a group +ID and an artifact ID. If you are building a project to be part of a +larger product that is already using Maven, you should attempt to follow +any patterns already established by other projects for consistency.</p> +<p>These identifiers should be comprised of <em>lowercase</em> letters, digits, +and hyphens only.</p> +<p>In general you should select a group ID that describes the entire +product, and artifact IDs that are the basis of filenames for each item +you distribute. The artifact ID may or may not overlap the group ID.</p> +<p>For example:</p> + +<div class="verbatim"> +<pre><code>maven : maven-core +maven : wagon-api +</code></pre></div> +<p>As previously mentioned, the artifact ID should be the basis of the +filename for the project, as by default Maven will use that and the +version to assemble the filename. Having the version as part of the +filename is strongly recommended to ensure that the version can be +determined at a glance without having to check a possibly non-existent +manifest, or compare file sizes with the official releases.</p> +<p>Following these guidelines are particularly encouraged when distributing +via the Maven Repository, to ensure that it can easily fit alongside +other projects and reduce the risk of conflicts and confusion.</p> +<p>More information about conventions for Maven coordinates is available +in the <a href="./guides/mini/guide-naming-conventions.html">Guide to Naming Conventions</a>.</p></section><section> +<h2>Directory Structure</h2> +<p>Maven encourages a common directory structure for a project. For more +information on this please refer to our <a href="./guides/introduction/introduction-to-the-standard-directory-layout.html">Introduction to the standard +directory +structure</a>.</p></section></section> </main> </div> </div> Modified: maven/website/content/maven-features.html ============================================================================== --- maven/website/content/maven-features.html (original) +++ maven/website/content/maven-features.html Sun May 12 07:42:36 2024 @@ -2,17 +2,17 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/apt/maven-features.apt at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/apt/maven-features.apt at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <meta name="author" content="Jason van Zyl" /> <meta name="date" content="2005-10-12" /> - <title>Maven</title> + <title>Maven â Maven Features</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -39,10 +39,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -50,9 +48,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/apt/maven-features.apt"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Maven Features <a href="https://github.com/apache/maven-site/tree/master/content/apt/maven-features.apt"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -131,7 +128,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Feature_Summary"></a> +<section> <h1>Feature Summary</h1> <p>The following are the key features of Maven in a nutshell:</p> <ul> Modified: maven/website/content/maven-jsr330.html ============================================================================== --- maven/website/content/maven-jsr330.html (original) +++ maven/website/content/maven-jsr330.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-jsr330.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-jsr330.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Maven & JSR-330</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-jsr330.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Maven & JSR-330 <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-jsr330.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -141,7 +138,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Maven_.26_JSR-330"></a> +<section> <h1>Maven & JSR-330</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -160,7 +157,7 @@ KIND, either express or implied. See th specific language governing permissions and limitations under the License. --> -<section><a id="Why_JSR-330.3F"></a> +<section> <h2>Why JSR-330?</h2> <p>Maven has a long history of using dependency injection (DI) by way of <a href="https://codehaus-plexus.github.io/plexus-containers/" class="externalLink">Plexus</a>, so the intent of using <a href="https://www.jcp.org/en/jsr/detail?id=330" class="externalLink">JSR-330</a> is to replace a custom DI mechanism (with custom Plexus <code>@Component</code>/<code>@Requirement</code> annotations) with something standard (with <code>@Named</code>/<code>@Inject</code> annotations). The implementation Maven @@ -173,10 +170,10 @@ written using the Plexus APIs.</p> but only with Maven 3.1.0 and later. Even though JSR-330 has been available in core since Maven 3.0-beta-3, it was made available to plugins and extensions only in Maven 3.1.0 (see <a href="https://issues.apache.org/jira/browse/MNG-5343" class="externalLink">MNG-5343</a> for more details).</p> <p>If you are interested the background of moving from Plexus to Guice and JSR-330, you can refer to the following “Plexus to Guice” articles from 2010: <a href="https://www.sonatype.com/people/2010/01/from-plexus-to-guice-1-why-guice/" class="externalLink">part 1</a>, <a href="https://www.sonatype.com/people/2010/01/from-plexus-to-guice-2-the-guiceplexus-bridge-and-custom-bean-injection/" class="externalLink">part 2</a> and <a href="https://www.sonatype.com/people/2010/01/from-plexus-to-guice-3-creating-a-guice-bean-extension-layer/" class="externalLink">part 3</a>.</p> -<p>If you are interested in migrating from Plexus Annotations to JSR-330, Sisu has a <a href="https://github.com/eclipse/sisu.plexus/wiki/Plexus-to-JSR330" class="externalLink">Plexus Migration documentation</a> that is done for you.</p></section><section><a id="How_to_use_JSR-330"></a> +<p>If you are interested in migrating from Plexus Annotations to JSR-330, Sisu has a <a href="https://github.com/eclipse/sisu.plexus/wiki/Plexus-to-JSR330" class="externalLink">Plexus Migration documentation</a> that is done for you.</p></section><section> <h2>How to use JSR-330</h2> <p>When you use JSR-330 in Maven plugins or extensions, there are two things you need to setup in your build:</p> -<ol style="list-style-type: decimal;"> +<ol style="list-style-type: decimal"> <li> <p>First you want a dependency on <code>javax.inject</code> so you can use the <code>@Inject</code>, <code>@Named</code>, and <code>@Singleton</code> annotations @@ -184,14 +181,14 @@ in your plugins and extensions (eventual <li> <p>Second you need to setup the <a href="https://eclipse.org/sisu/docs/api/org.eclipse.sisu.mojos/" class="externalLink"><code>sisu-maven-plugin</code></a> to index the JSR-330 components you want made available to Maven. The <a href="https://eclipse.org/sisu/docs/api/org.eclipse.sisu.mojos/" class="externalLink"><code>sisu-maven-plugin</code></a> creates its index in <code>META-INF/sisu/javax.inject.Named</code> (eventually in addition to <a href="https://codehaus-plexus.github.io/plexus-containers/plexus-component-metadata/" class="externalLink"><code>plexus-component-metadata</code></a>).</p></li> -</ol><section><a id="Implementation_Details"></a> +</ol><section> <h3>Implementation Details</h3> <p>If you take a look in that <code>META-INF/sisu/javax.inject.Named</code> file with the example from the next paragraph, you will see a list of full class names.</p> <p>Enumerating the implementations means that no classpath scanning is required in runtime to find them, which keeps Maven's startup time fast. Note that our container is configured by default to only use the index. While this keeps things fast, if you use JSR-330 components in dependencies that do not contain an index, those implementations will currently not be discovered. This is a compromise that is reasonable given Maven is a command-line tool where startup speed -is important.</p></section></section><section><a id="How_to_use_JSR-330_in_plugins"></a> +is important.</p></section></section><section> <h2>How to use JSR-330 in plugins</h2> <p>Let's take a look at an example plugin: If you want to look at this example project, you can find the code <a href="https://github.com/apache/maven-integration-testing/tree/master/core-it-suite/src/test/resources/mng-5382" class="externalLink">in Maven Core ITs</a>.</p> <p>The POM is setup for JSR-300 as previously mentioned, with the <code>javax.inject</code> dependency and the <code>sisu-maven-plugin</code> configured to create @@ -199,6 +196,7 @@ the JSR-330 component index.</p> <p>In addition, we add classical Maven plugin dependencies <code>maven-plugin-api</code> and <code>maven-plugin-annotations</code> to extend the <code>AbstractMojo</code> and use the Java Plugin Tools Annotations with associated <code>maven-plugin-plugin</code> (see <a href="/plugin-tools/">Maven Plugin Tools</a>).</p> +<div class="verbatim"> <pre><code class="language-xml"><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> @@ -284,13 +282,14 @@ the JSR-330 component index.</p> </plugins> </build> </project> -</code></pre> +</code></pre></div> <p>Now let's take a look at the plugin code. You'll notice that we're using constructor injection which makes testing a lot easier. If you want to test your <code>Jsr330Component</code>, you do not need the container to instantiate the <code>Mojo</code>. In this simple case, you can actually test this plugin without using the <a href="/plugin-testing/maven-plugin-testing-harness/index.html">plugin testing harness</a> because you can instantiate the <code>Jsr330Component</code> and <code>Jsr330Mojo</code> directly and wire everything up manually using the constructor. Constructor injection, which Plexus lacks, greatly simplifies testing.</p> +<div class="verbatim"> <pre><code class="language-java">package org.apache.maven.plugins; import javax.inject.Inject; @@ -322,7 +321,7 @@ public class Jsr330Mojo component.hello(); } } -</code></pre></section></section> +</code></pre></div></section></section> </main> </div> </div> Modified: maven/website/content/maven-logging.html ============================================================================== --- maven/website/content/maven-logging.html (original) +++ maven/website/content/maven-logging.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-logging.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-logging.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Maven 3.1.x logging</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-logging.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Maven 3.1.x logging <a href="https://github.com/apache/maven-site/tree/master/content/markdown/maven-logging.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -141,7 +138,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Maven_3.1.x_logging"></a> +<section> <h1>Maven 3.1.x logging</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -178,6 +175,7 @@ see the following layout where the <code <code>slf4j-simple-x.y.z.jar</code> (or <code>maven-slf4j-provider-3.x.y.jar</code> since 3.5.0) specifically relate to the SLF4J implementation:</p> <div class="source"> +<div class="verbatim"> <pre> apache-maven-3.x.y ├── LICENSE.txt @@ -196,8 +194,8 @@ apache-maven-3.x.y ├── slf4j-api-x.y.z.jar ├── slf4j-simple-x.y.z.jar or maven-slf4j-provider-3.x.y.jar └── ... -</pre></div> -<section><a id="Configuring_logging"></a> +</pre></div></div> +<section> <h2>Configuring logging</h2> <p>To configure logging with the <a href="https://www.slf4j.org/apidocs/org/slf4j/impl/SimpleLogger.html" class="externalLink">SLF4J Simple</a>, you can edit the properties in the <code>${maven.home}/conf/logging/simplelogger.properties</code> file. Please see the linked reference documentation @@ -208,12 +206,12 @@ for details.</p> <li><code>MAVEN_OPTS=-Dorg.slf4j.simpleLogger.showThreadName=true mvn <goals></code> will add the thread name to every logging line,</li> <li><code>MAVEN_OPTS=-Dorg.slf4j.simpleLogger.showLogName=true mvn <goals></code> will add the logger name to every logging line,</li> </ul> -<p>The default SLF4J configuration for Maven is listed <a href="https://github.com/apache/maven/blob/master/apache-maven/src/assembly/maven/conf/logging/simplelogger.properties" class="externalLink">here</a>, where you can see other useful property names to customise logging.</p></section><section><a id="Changing_the_SLF4J_implementation"></a> +<p>The default SLF4J configuration for Maven is listed <a href="https://github.com/apache/maven/blob/master/apache-maven/src/assembly/maven/conf/logging/simplelogger.properties" class="externalLink">here</a>, where you can see other useful property names to customise logging.</p></section><section> <h2>Changing the SLF4J implementation</h2> <p>If you want use a different logging implementation it is simply a matter of removing the slf4j-simple JAR from the <code>lib</code> directory and replacing it with one of the alternative implementations, like <a href="https://logging.apache.org/log4j/2.x/log4j-slf4j-impl/" class="externalLink">Log4j2</a> or <a href="http://logback.qos.ch" class="externalLink">Logback</a>.</p> <p>See SLF4J documentation for more details on <a href="https://www.slf4j.org/manual.html#swapping" class="externalLink">swapping “SLF4J bindings”</a>.</p> -<p>Note: with the introduction of colors in Maven 3.5.0, perhaps an equivalent work to <a href="https://maven.apache.org/ref/current/maven-slf4j-provider/" class="externalLink"><code>maven-slf4j-provider</code></a> may be required or you'll loose colors.</p></section><section><a id="Maven_implemenation_details"></a> +<p>Note: with the introduction of colors in Maven 3.5.0, perhaps an equivalent work to <a href="https://maven.apache.org/ref/current/maven-slf4j-provider/" class="externalLink"><code>maven-slf4j-provider</code></a> may be required or you'll loose colors.</p></section><section> <h2>Maven implemenation details</h2> <p><a href="/ref/current/maven-embedder/logging.html">More technical details</a> can be found in Maven release reference documentation.</p></section></section> </main> Modified: maven/website/content/maven-site-1.0-site.jar ============================================================================== Binary files - no diff available.