You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by sv...@apache.org on 2024/05/11 11:53:26 UTC
svn commit: r1917667 [21/26] - in /maven/website/content: ./ archives/maven-2.x/ background/ developers/ developers/conventions/ developers/release/ developers/website/ docs/ docs/2.0.1/ docs/2.0.10/ docs/2.0.11/ docs/2.0.2/ docs/2.0.3/ docs/2.0.4/ doc...
Modified: maven/website/content/ide.html
==============================================================================
--- maven/website/content/ide.html (original)
+++ maven/website/content/ide.html Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/ide.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/ide.md at 2024-05-11
| 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-M10" />
- <title>Maven â Apache Maven IDE Integration</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 ">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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -133,7 +136,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
+<section><a id="Apache_Maven_IDE_Integration"></a>
<h1>Apache Maven IDE Integration</h1><!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
@@ -153,11 +156,11 @@ specific language governing permissions
under the License.
-->
-<p>All popular development environments for the Java platform support Apache Maven.</p><section>
+<p>All popular development environments for the Java platform support Apache Maven.</p><section><a id="Apache_NetBeans_IDE"></a>
<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>
+<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>
<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>
@@ -175,7 +178,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>
+Eclipse workspace with those changes.</p></section><section><a id="JetBrains_IntelliJ_IDEA"></a>
<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 Sat May 11 11:53:23 2024
@@ -2,18 +2,18 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/xdoc/index.xml.vm at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/xdoc/index.xml.vm at 2024-05-11
| 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-M10" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
<meta name="author" content="Brett Porter" />
<meta name="author" content="Jason van Zyl" />
<meta name="author" content="Olivier Lamy" />
- <title>Maven â Welcome to Apache Maven</title>
+ <title>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,8 +40,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -49,7 +51,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 ">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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -132,7 +135,7 @@
- <section>
+ <section><a id="Welcome_to_Apache_Maven"></a>
<h1>Welcome to Apache Maven</h1>
@@ -231,7 +234,7 @@
If you are looking for a quick reference, you can use the <a href="guides/index.html">documentation index</a>.
</p>
- <section><section>
+ <section><a id="How_to_Get_Support"></a><section><a id="How_to_Get_Support"></a>
<h3>How to Get Support</h3>
<p>
@@ -255,7 +258,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 Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/install.md.vm at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/install.md.vm at 2024-05-11
| 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-M10" />
- <title>Maven â Installing Apache Maven</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 ">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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -133,7 +136,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
+<section><a id="Installing_Apache_Maven"></a>
<h1>Installing Apache Maven</h1><!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
@@ -164,14 +167,12 @@ 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></div>
+</code></pre>
<p>or</p>
-<div class="verbatim">
<pre><code class="language-sh">tar xzvf apache-maven-3.9.6-bin.tar.gz
-</code></pre></div>
+</code></pre>
<p>Alternatively use your preferred archive extraction tool.</p>
<ul>
@@ -182,14 +183,13 @@ 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></div></section>
+</code></pre></section>
</main>
</div>
</div>
Modified: maven/website/content/issue-management.html
==============================================================================
--- maven/website/content/issue-management.html (original)
+++ maven/website/content/issue-management.html Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/issue-management.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/issue-management.md at 2024-05-11
| 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-M10" />
- <title>Maven â Overview</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 ">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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -126,52 +129,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<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>
+<section>
</main>
</div>
</div>
Modified: maven/website/content/mailing-lists.html
==============================================================================
--- maven/website/content/mailing-lists.html (original)
+++ maven/website/content/mailing-lists.html Sat May 11 11:53:23 2024
@@ -2,14 +2,14 @@
<!--
- | 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-11
+ | 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
| 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-M10" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
<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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
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 Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-1.x-eol.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-1.x-eol.md at 2024-05-11
| 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-M10" />
- <title>Maven â End Of Life Apache Maven 1.x</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 ">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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -126,43 +129,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<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>
+<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 Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-2.x-eol.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-2.x-eol.md at 2024-05-11
| 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-M10" />
- <title>Maven â End Of Life Apache Maven 2.x</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 ">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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -126,7 +129,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
+<section><a id="End_Of_Life_Apache_Maven_2.x"></a>
<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
@@ -155,7 +158,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>
+</ul><section><a id="List_Of_Last_Plugins_Versions_Which_Support_Maven_2.x"></a>
<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 Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-ci-friendly.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-ci-friendly.md at 2024-05-11
| 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-M10" />
- <title>Maven â Maven CI Friendly Versions</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -126,7 +129,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
+<section><a id="Maven_CI_Friendly_Versions"></a>
<h1>Maven CI Friendly Versions</h1><!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
@@ -147,11 +150,10 @@ 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>
+and/or <code>${changelist}</code> as placeholders for the version in your pom file.</p><section><a id="Single_Project_Setup"></a>
<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>
@@ -165,25 +167,22 @@ and/or <code>${changelist}</code> as pla
<version>${revision}</version>
...
</project>
-</code></pre></div>
+</code></pre>
<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></div>
+</code></pre>
<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></div>
+</code></pre>
<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>
@@ -200,19 +199,17 @@ to simply use a property inside the pom
<revision>1.0.0-SNAPSHOT</revision>
</properties>
</project>
-</code></pre></div>
+</code></pre>
<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></div>
+</code></pre>
<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>
@@ -229,12 +226,11 @@ named properties like this:</p>
<revision>1.0.0-${buildNumber}-SNAPSHOT</revision>
</properties>
</project>
-</code></pre></div>
+</code></pre>
<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>
@@ -253,31 +249,27 @@ different properties like this:</p>
<sha1/>
</properties>
</project>
-</code></pre></div>
+</code></pre>
<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></div>
+</code></pre>
<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></div>
+</code></pre>
<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></div>
-<p>Please read until the end of this documentation!</p></section><section>
+</code></pre>
+<p>Please read until the end of this documentation!</p></section><section><a id="Multi_Module_Setup"></a>
<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>
@@ -298,10 +290,9 @@ The parent pom will look like this:</p>
..
</modules>
</project>
-</code></pre></div>
+</code></pre>
<p>The child will look like this:</p>
-<div class="verbatim">
<pre><code class="language-xml"><project>
<modelVersion>4.0.0</modelVersion>
<parent>
@@ -313,16 +304,15 @@ The parent pom will look like this:</p>
<artifactId>ci-child</artifactId>
...
</project>
-</code></pre></div>
+</code></pre>
<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>
+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>
<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>
@@ -343,10 +333,9 @@ versions has been to use <code>${project
..
</modules>
</project>
-</code></pre></div>
+</code></pre>
<p>The child will look like this:</p>
-<div class="verbatim">
<pre><code class="language-xml"><project>
<modelVersion>4.0.0</modelVersion>
<parent>
@@ -365,16 +354,15 @@ versions has been to use <code>${project
</dependency>
</dependencies>
</project>
-</code></pre></div>
+</code></pre>
<p>If you try to use <code>${revision}</code> instead of <code>${project.version}</code> your build
-will fail.</p></section><section>
+will fail.</p></section><section><a id="Install_.2F_Deploy"></a>
<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>
@@ -425,7 +413,7 @@ will look like this:</p>
..
</modules>
</project>
-</code></pre></div></section></section>
+</code></pre></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 Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-conventions.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-conventions.md at 2024-05-11
| 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-M10" />
- <title>Maven â Maven Conventions</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -126,66 +129,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<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>
+<section>
</main>
</div>
</div>
Modified: maven/website/content/maven-features.html
==============================================================================
--- maven/website/content/maven-features.html (original)
+++ maven/website/content/maven-features.html Sat May 11 11:53:23 2024
@@ -2,17 +2,17 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/apt/maven-features.apt at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/apt/maven-features.apt at 2024-05-11
| 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-M10" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
<meta name="author" content="Jason van Zyl" />
<meta name="date" content="2005-10-12" />
- <title>Maven â Maven Features</title>
+ <title>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" />
@@ -39,8 +39,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -48,7 +50,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 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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -128,7 +131,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
+<section><a id="Feature_Summary"></a>
<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 Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-jsr330.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-jsr330.md at 2024-05-11
| 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-M10" />
- <title>Maven â Maven & JSR-330</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 & 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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -138,7 +141,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
+<section><a id="Maven_.26_JSR-330"></a>
<h1>Maven & JSR-330</h1><!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
@@ -157,7 +160,7 @@ KIND, either express or implied. See th
specific language governing permissions and limitations
under the License.
-->
-<section>
+<section><a id="Why_JSR-330.3F"></a>
<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
@@ -170,10 +173,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>
+<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>
<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
@@ -181,14 +184,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>
+</ol><section><a id="Implementation_Details"></a>
<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>
+is important.</p></section></section><section><a id="How_to_use_JSR-330_in_plugins"></a>
<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
@@ -196,7 +199,6 @@ 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>
@@ -282,14 +284,13 @@ the JSR-330 component index.</p>
</plugins>
</build>
</project>
-</code></pre></div>
+</code></pre>
<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;
@@ -321,7 +322,7 @@ public class Jsr330Mojo
component.hello();
}
}
-</code></pre></div></section></section>
+</code></pre></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 Sat May 11 11:53:23 2024
@@ -2,15 +2,15 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/maven-logging.md at 2024-05-11
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/maven-logging.md at 2024-05-11
| 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-M10" />
- <title>Maven â Maven 3.1.x logging</title>
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" />
+ <title>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,8 +37,10 @@
<div class="container-fluid">
<header>
<div id="banner">
- <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="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="clear"><hr/></div>
</div>
@@ -46,7 +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 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 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="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
@@ -138,7 +141,7 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
+<section><a id="Maven_3.1.x_logging"></a>
<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
@@ -175,7 +178,6 @@ 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
@@ -194,8 +196,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></div>
-<section>
+</pre></div>
+<section><a id="Configuring_logging"></a>
<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
@@ -206,12 +208,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>
+<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>
<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>
+<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>
<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.