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/12/29 13:41:22 UTC
svn commit: r1922740 [4/6] - 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/ docs/...
Modified: maven/website/content/guides/introduction/introduction-to-profiles.html
==============================================================================
--- maven/website/content/guides/introduction/introduction-to-profiles.html (original)
+++ maven/website/content/guides/introduction/introduction-to-profiles.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-profiles.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-profiles.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Introduction to build profiles <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/introduction/introduction-to-profiles.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/introduction/introduction-to-repositories.html
==============================================================================
--- maven/website/content/guides/introduction/introduction-to-repositories.html (original)
+++ maven/website/content/guides/introduction/introduction-to-repositories.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-repositories.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-repositories.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -49,7 +49,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Introduction to Repositories <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/introduction/introduction-to-repositories.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/introduction/introduction-to-the-lifecycle.html
==============================================================================
--- maven/website/content/guides/introduction/introduction-to-the-lifecycle.html (original)
+++ maven/website/content/guides/introduction/introduction-to-the-lifecycle.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-the-lifecycle.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-the-lifecycle.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -49,7 +49,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Introduction to the Build Lifecycle <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/introduction/introduction-to-the-lifecycle.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
@@ -151,21 +151,17 @@
</header>
<main id="bodyColumn" class="span10">
<section><a id="Introduction_to_the_Build_Lifecycle"></a>
-<h1>Introduction to the Build Lifecycle</h1><section><a id="Table_Of_Contents"></a>
-<h2>Table Of Contents</h2>
+<h1>Introduction to the Build Lifecycle</h1>
<ul>
<li><a href="#Build_Lifecycle_Basics">Build Lifecycle Basics</a></li>
-<li><a href="#Setting_Up_Your_Project_to_Use_the_Build_Lifecycle">Setting Up Your Project to Use the Build Lifecycle</a>
-<ul>
-<li><a href="#Packaging">Packaging</a></li>
-<li><a href="#Plugins">Plugins</a></li></ul></li>
+<li><a href="#Setting_Up_Your_Project_to_Use_the_Build_Lifecycle">Setting Up Your Project to Use the Build Lifecycle</a></li>
<li><a href="#Lifecycle_Reference">Lifecycle Reference</a></li>
-<li><a href="#Built-in_Lifecycle_Bindings">Built-in Lifecycle Bindings</a></li></ul></section><section>
-<h2><a id="Build_Lifecycle_Basics">Build Lifecycle Basics</a></h2>
+<li><a href="#Built-in_Lifecycle_Bindings">Built-in Lifecycle Bindings</a></li></ul><section><a id="Build_Lifecycle_Basics"></a>
+<h2>Build Lifecycle Basics</h2>
<p>Maven is based around the central concept of a build lifecycle. What this means is that the process for building and distributing a particular artifact (project) is clearly defined.</p>
<p>For the person building a project, this means that it is only necessary to learn a small set of commands to build any Maven project, and the <a href="./introduction-to-the-pom.html">POM</a> will ensure they get the results they desired.</p>
-<p>There are three built-in build lifecycles: default, clean and site. The <code>default</code> lifecycle handles your project deployment, the <code>clean</code> lifecycle handles project cleaning, while the <code>site</code> lifecycle handles the creation of your project's web site.</p><section>
-<h3><a id="A_Build_Lifecycle_is_Made_Up_of_Phases">A Build Lifecycle is Made Up of Phases</a></h3>
+<p>There are three built-in build lifecycles: default, clean and site. The <code>default</code> lifecycle handles your project deployment, the <code>clean</code> lifecycle handles project cleaning, while the <code>site</code> lifecycle handles the creation of your project's web site.</p><section><a id="A_Build_Lifecycle_is_Made_Up_of_Phases"></a>
+<h3>A Build Lifecycle is Made Up of Phases</h3>
<p>Each of these build lifecycles is defined by a different list of build phases, wherein a build phase represents a stage in the lifecycle.</p>
<p>For example, the default lifecycle comprises of the following phases (for a complete list of the lifecycle phases, refer to the <a href="#Lifecycle_Reference">Lifecycle Reference</a>):</p>
<ul>
@@ -177,8 +173,8 @@
<li><code>install</code> - install the package into the local repository, for use as a dependency in other projects locally</li>
<li><code>deploy</code> - done in the build environment, copies the final package to the remote repository for sharing with other developers and projects.</li></ul>
<p>These lifecycle phases (plus the other lifecycle phases not shown here) are executed sequentially to complete the <code>default</code> lifecycle. Given the lifecycle phases above, this means that when the default lifecycle is used, Maven will first validate the project, then will try to compile the sources, run those against the tests, package the binaries (e.g. jar), run integration tests against that package, verify the integration tests, install the verified package to the local repository, then deploy the installed package to a remote repository.</p>
-<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section>
-<h3><a id="Usual_Command_Line_Calls">Usual Command Line Calls</a></h3>
+<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section><a id="Usual_Command_Line_Calls"></a>
+<h3>Usual Command Line Calls</h3>
<p>You should select the phase that matches your outcome. If you want your jar, run <code>package</code>. If you want to run the unit tests, run <code>test</code>.</p>
<p>If you are uncertain what you want, the preferred phase to call is</p>
<pre>mvn verify</pre>
@@ -186,8 +182,8 @@
<p>In a build environment, use the following call to cleanly build and deploy artifacts into the shared repository.</p>
<pre>mvn clean deploy</pre>
<p>The same command can be used in a multi-module scenario (i.e. a project with one or more subprojects). Maven traverses into every subproject and executes <code>clean</code>, then executes <code>deploy</code> (including all of the prior build phase steps).</p>
-<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section>
-<h3><a id="A_Build_Phase_is_Made_Up_of_Plugin_Goals">A Build Phase is Made Up of Plugin Goals</a></h3>
+<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section><a id="A_Build_Phase_is_Made_Up_of_Plugin_Goals"></a>
+<h3>A Build Phase is Made Up of Plugin Goals</h3>
<p>However, even though a build phase is responsible for a specific step in the build lifecycle, the manner in which it carries out those responsibilities may vary. And this is done by declaring the plugin goals bound to those build phases.</p>
<p>A plugin goal represents a specific task (finer than a build phase) which contributes to the building and managing of a project. It may be bound to zero or more build phases. A goal not bound to any build phase could be executed outside of the build lifecycle by direct invocation. The order of execution depends on the order in which the goal(s) and the build phase(s) are invoked. For example, consider the command below. The <code>clean</code> and <code>package</code> arguments are build phases, while the <code>dependency:copy-dependencies</code> is a goal (of a plugin).</p>
<pre>mvn clean dependency:copy-dependencies package</pre>
@@ -195,15 +191,15 @@
<p>Moreover, if a goal is bound to one or more build phases, that goal will be called in all those phases.</p>
<p>Furthermore, a build phase can also have zero or more goals bound to it. If a build phase has no goals bound to it, that build phase will not execute. But if it has one or more goals bound to it, it will execute all those goals.</p>
<p>Multiple goals bound to a phase are executed in the same order as they are declared in the POM. Multiple instances of the same plugin are grouped to execute together.</p>
-<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section>
-<h3><a id="Some_Phases_Are_Not_Usually_Called_From_the_Command_Line">Some Phases Are Not Usually Called From the Command Line</a></h3>
+<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section><a id="Some_Phases_Are_Not_Usually_Called_From_the_Command_Line"></a>
+<h3>Some Phases Are Not Usually Called From the Command Line</h3>
<p>The phases named with hyphenated-words (<code>pre-*</code>, <code>post-*</code>, or <code>process-*</code>) are not usually directly called from the command line. These phases sequence the build, producing intermediate results that are not useful outside the build. In the case of invoking <code>integration-test</code>, the environment may be left in a hanging state.</p>
<p>Code coverage tools such as Jacoco and execution container plugins such as Tomcat, Cargo, and Docker bind goals to the <code>pre-integration-test</code> phase to prepare the integration test container environment. These plugins also bind goals to the <code>post-integration-test</code> phase to collect coverage statistics or decommission the integration test container.</p>
<p>Failsafe and code coverage plugins bind goals to <code>integration-test</code> and <code>verify</code> phases. The net result is test and coverage reports are available after the <code>verify</code> phase. If <code>integration-test</code> were to be called from the command line, no reports are generated. Worse is that the integration test container environment is left in a hanging state; the Tomcat webserver or Docker instance is left running, and Maven may not even terminate by itself.</p>
-<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section></section><section>
-<h2><a id="Setting_Up_Your_Project_to_Use_the_Build_Lifecycle">Setting Up Your Project to Use the Build Lifecycle</a></h2>
-<p>The build lifecycle is simple enough to use, but when you are constructing a Maven build for a project, how do you go about assigning tasks to each of those build phases?</p><section>
-<h3><a id="Packaging">Packaging</a></h3>
+<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section></section><section><a id="Setting_Up_Your_Project_to_Use_the_Build_Lifecycle"></a>
+<h2>Setting Up Your Project to Use the Build Lifecycle</h2>
+<p>The build lifecycle is simple enough to use, but when you are constructing a Maven build for a project, how do you go about assigning tasks to each of those build phases?</p><section><a id="Packaging"></a>
+<h3>Packaging</h3>
<p>The first, and most common way, is to set the packaging for your project via the equally named POM element <code><packaging></code>. Some of the valid packaging values are <code>jar</code>, <code>war</code>, <code>ear</code> and <code>pom</code>. If no packaging value has been specified, it will default to <code>jar</code>.</p>
<p>Each packaging contains a list of goals to bind to a particular phase. For example, the <code>jar</code> packaging will bind the following goals to build phases of the default lifecycle.</p>
<table class="table table-bordered table-striped">
@@ -236,8 +232,8 @@
<td style="text-align: left;"><code>deploy:deploy</code></td></tr></table>
<p>This is an almost <a href="/ref/current/maven-core/default-bindings.html">standard set of bindings</a>; however, some packagings handle them differently. For example, a project that is purely metadata (packaging value is <code>pom</code>) only binds goals to the <code>install</code> and <code>deploy</code> phases (for a complete list of goal-to-build-phase bindings of some of the packaging types, refer to the <a href="#Lifecycle_Reference">Lifecycle Reference</a>).</p>
<p>Note that for some packaging types to be available, you may also need to include a particular plugin in the <code><build></code> section of your POM and specify <code><extensions>true</extensions></code> for that plugin. One example of a plugin that requires this is the Plexus plugin, which provides a <code>plexus-application</code> and <code>plexus-service</code> packaging.</p>
-<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section>
-<h3><a id="Plugins">Plugins</a></h3>
+<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section><section><a id="Plugins"></a>
+<h3>Plugins</h3>
<p>The second way to add goals to phases is to configure plugins in your project. Plugins are artifacts that provide goals to Maven. Furthermore, a plugin may have one or more goals wherein each goal represents a capability of that plugin. For example, the Compiler plugin has two goals: <code>compile</code> and <code>testCompile</code>. The former compiles the source code of your main code, while the latter compiles the source code of your test code.</p>
<p>As you will see in the later sections, plugins can contain information that indicates which lifecycle phase to bind a goal to. Note that adding the plugin on its own is not enough information - you must also specify the goals you want to run as part of your build.</p>
<p>The goals that are configured will be added to the goals already bound to the lifecycle from the packaging selected. If more than one goal is bound to a particular phase, the order used is that those from the packaging are executed first, followed by those configured in the POM. Note that you can use the <code><executions></code> element to gain more control over the order of particular goals.</p>
@@ -276,8 +272,8 @@
</execution>
</executions>
</plugin></code></pre>
-<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section></section><section>
-<h2><a id="Lifecycle_Reference">Lifecycle Reference</a></h2>
+<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section></section><section><a id="Lifecycle_Reference"></a>
+<h2>Lifecycle Reference</h2>
<p>The following lists all build phases of the <code>default</code>, <code>clean</code> and <code>site</code> lifecycles, which are executed in the order given up to the point of the one specified.</p><section><a id="Clean_Lifecycle"></a>
<h3>Clean Lifecycle</h3>
<table class="table table-bordered table-striped">
@@ -384,8 +380,8 @@
<tr class="a">
<td style="text-align: left;"><code>site-deploy</code></td>
<td style="text-align: left;">deploy the generated site documentation to the specified web server</td></tr></table>
-<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section></section><section>
-<h2><a id="Built-in_Lifecycle_Bindings">Built-in Lifecycle Bindings</a></h2>
+<p><i><a href="./introduction-to-the-lifecycle.html">[top]</a>.</i></p></section></section><section><a id="Built-in_Lifecycle_Bindings"></a>
+<h2>Built-in Lifecycle Bindings</h2>
<p>Some phases have goals bound to them by default. And for the default lifecycle, these bindings depend on the packaging value. Here are some of the goal-to-build-phase bindings.</p><section><a id="Clean_Lifecycle_Bindings"></a>
<h3>Clean Lifecycle Bindings</h3>
<table class="table table-bordered table-striped">
Modified: maven/website/content/guides/introduction/introduction-to-the-pom.html
==============================================================================
--- maven/website/content/guides/introduction/introduction-to-the-pom.html (original)
+++ maven/website/content/guides/introduction/introduction-to-the-pom.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-the-pom.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-the-pom.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -50,7 +50,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Introduction to the POM <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/introduction/introduction-to-the-pom.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
@@ -154,32 +154,32 @@
<section><a id="Introduction_to_the_POM"></a>
<h1>Introduction to the POM</h1>
<ul>
-<li><a href="./introduction-to-the-pom.html#What_is_a_POM">What is a POM</a>?</li>
-<li><a href="./introduction-to-the-pom.html#Super_POM">Super POM</a></li>
-<li><a href="./introduction-to-the-pom.html#Minimal_POM">Minimal POM</a></li>
-<li><a href="./introduction-to-the-pom.html#Project_Inheritance">Project Inheritance</a>
+<li><a href="#What_is_a_POM.3F">What is a POM?</a></li>
+<li><a href="#Super_POM">Super POM</a></li>
+<li><a href="#Minimal_POM">Minimal POM</a></li>
+<li><a href="#Project_Inheritance">Project Inheritance</a>
<ul>
-<li><a href="./introduction-to-the-pom.html#Example_1">Example 1</a></li>
-<li><a href="./introduction-to-the-pom.html#Example_2">Example 2</a></li></ul></li>
-<li><a href="./introduction-to-the-pom.html#Project_Aggregation">Project Aggregation</a>
+<li><a href="#Example_1">Example 1</a></li>
+<li><a href="#Example_2">Example 2</a></li></ul></li>
+<li><a href="#Project_Aggregation">Project Aggregation</a>
<ul>
-<li><a href="./introduction-to-the-pom.html#Example_3">Example 3</a></li>
-<li><a href="./introduction-to-the-pom.html#Example_4">Example 4</a></li></ul></li>
-<li><a href="./introduction-to-the-pom.html#Project_Inheritance_vs_Project_Aggregation">Project Inheritance vs Project Aggregation</a>
+<li><a href="#Example_3">Example 3</a></li>
+<li><a href="#Example_4">Example 4</a></li></ul></li>
+<li><a href="#Project_Inheritance_vs_Project_Aggregation">Project Inheritance vs Project Aggregation</a>
<ul>
-<li><a href="./introduction-to-the-pom.html#Example_5">Example 5</a></li></ul></li>
-<li><a href="./introduction-to-the-pom.html#Project_Interpolation">Project Interpolation and Variables</a>
+<li><a href="#Example_5">Example 5</a></li></ul></li>
+<li><a href="#Project_Interpolation_and_Variables">Project Interpolation and Variables</a>
<ul>
-<li><a href="./introduction-to-the-pom.html#Available_Variables">Available Variables</a></li></ul></li></ul><section>
-<h2><a id="What_is_a_POM">What is a POM</a>?</h2>
+<li><a href="#Available_Variables">Available Variables</a></li></ul></li></ul><section><a id="What_is_a_POM.3F"></a>
+<h2>What is a POM?</h2>
<p>A Project Object Model or POM is the fundamental unit of work in Maven. It is an XML file that contains information about the project and configuration details used by Maven to build the project. It contains default values for most projects. Examples for this is the build directory, which is <code>target</code>; the source directory, which is <code>src/main/java</code>; the test source directory, which is <code>src/test/java</code>; and so on. When executing a task or goal, Maven looks for the POM in the current directory. It reads the POM, gets the needed configuration information, then executes the goal.</p>
<p>Some of the configuration that can be specified in the POM are the project dependencies, the plugins or goals that can be executed, the build profiles, and so on. Other information such as the project version, description, developers, mailing lists and such can also be specified.</p>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p></section><section>
-<h2><a id="Super_POM">Super POM</a></h2>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p></section><section><a id="Super_POM"></a>
+<h2>Super POM</h2>
<p>The Super POM is Maven's default POM. All POMs extend the Super POM unless explicitly set, meaning the configuration specified in the Super POM is inherited by the POMs you created for your projects.</p>
<p>You can see the <a href="/maven-model-builder/super-pom.html">Super POM for the latest Maven 3 release</a> in Maven Core reference documentation.</p>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p></section><section>
-<h2><a id="Minimal_POM">Minimal POM</a></h2>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p></section><section><a id="Minimal_POM"></a>
+<h2>Minimal POM</h2>
<p>The minimum requirement for a POM are the following:</p>
<ul>
<li><code>project</code> root</li>
@@ -198,8 +198,8 @@
<p>A POM requires that its groupId, artifactId, and version be configured. These three values form the project's fully qualified artifact name. This is in the form of <groupId>:<artifactId>:<version>. As for the example above, its fully qualified artifact name is "com.mycompany.app:my-app:1".</p>
<p>Also, as mentioned in the <a href="#What_is_a_POM">first section</a>, if the configuration details are not specified, Maven will use their defaults. One of these default values is the packaging type. Every Maven project has a packaging type. If it is not specified in the POM, then the default value "jar" would be used.</p>
<p>Furthermore, you can see that in the minimal POM the <i>repositories</i> were not specified. If you build your project using the minimal POM, it would inherit the <i>repositories</i> configuration in the Super POM. Therefore when Maven sees the dependencies in the minimal POM, it would know that these dependencies will be downloaded from <code>https://repo.maven.apache.org/maven2</code> which was specified in the Super POM.</p>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p></section><section>
-<h2><a id="Project_Inheritance">Project Inheritance</a></h2>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p></section><section><a id="Project_Inheritance"></a>
+<h2>Project Inheritance</h2>
<p>Elements in the POM that are merged are the following:</p>
<ul>
<li>dependencies</li>
@@ -208,8 +208,8 @@
<li>plugin executions with matching ids</li>
<li>plugin configuration</li>
<li>resources</li></ul>
-<p>The Super POM is one example of project inheritance, however you can also introduce your own parent POMs by specifying the parent element in the POM, as demonstrated in the following examples.</p><section>
-<h3><a id="Example_1">Example 1</a></h3><section><a id="The_Scenario"></a>
+<p>The Super POM is one example of project inheritance, however you can also introduce your own parent POMs by specifying the parent element in the POM, as demonstrated in the following examples.</p><section><a id="Example_1"></a>
+<h3>Example 1</h3><section><a id="The_Scenario"></a>
<h4>The Scenario</h4>
<p>As an example, let us reuse our previous artifact, com.mycompany.app:my-app:1. And let us introduce another artifact, com.mycompany.app:my-module:1.</p>
<pre class="prettyprint linenums"><code><project>
@@ -255,8 +255,8 @@
<artifactId>my-module</artifactId>
</project></code></pre>
<p>This allows the module to inherit the groupId or the version of its parent POM.</p>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p></section></section><section>
-<h3><a id="Example_2">Example 2</a></h3><section><a id="The_Scenario_1"></a>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p></section></section><section><a id="Example_2"></a>
+<h3>Example 2</h3><section><a id="The_Scenario_1"></a>
<h4>The Scenario</h4>
<p>However, that would work if the parent project was already installed in our local repository or was in that specific directory structure (parent <code>pom.xml</code> is one directory higher than that of the module's <code>pom.xml</code>).</p>
<p>But what if the parent is not yet installed and if the directory structure is as in the following example?</p>
@@ -279,14 +279,14 @@
<artifactId>my-module</artifactId>
</project></code></pre>
-<p>As the name suggests, it's the relative path from the module's <code>pom.xml</code> to the parent's <code>pom.xml</code>.</p></section></section></section><section>
-<h2><a id="Project_Aggregation">Project Aggregation</a></h2>
+<p>As the name suggests, it's the relative path from the module's <code>pom.xml</code> to the parent's <code>pom.xml</code>.</p></section></section></section><section><a id="Project_Aggregation"></a>
+<h2>Project Aggregation</h2>
<p>Project Aggregation is similar to <a href="#Project_Inheritance">Project Inheritance</a>. But instead of specifying the parent POM from the module, it specifies the modules from the parent POM. By doing so, the parent project now knows its modules, and if a Maven command is invoked against the parent project, that Maven command will then be executed to the parent's modules as well. To do Project Aggregation, you must do the following:</p>
<ul>
<li>Change the parent POMs packaging to the value "pom".</li>
<li>Specify in the parent POM the directories of its modules (children POMs).</li></ul>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p><section>
-<h3><a id="Example_3">Example 3</a></h3><section><a id="The_Scenario_2"></a>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p><section><a id="Example_3"></a>
+<h3>Example 3</h3><section><a id="The_Scenario_2"></a>
<h4>The Scenario</h4>
<p>Given the previous original artifact POMs and directory structure:</p>
<p><b>com.mycompany.app:my-app:1's POM</b></p>
@@ -326,8 +326,8 @@
</project></code></pre>
<p>In the revised com.mycompany.app:my-app:1, the packaging section and the modules sections were added. For the packaging, its value was set to "pom", and for the modules section, we have the element <code><module>my-module</module></code>. The value of <code><module></code> is the relative path from the com.mycompany.app:my-app:1 to com.mycompany.app:my-module:1's POM (<i>by practice, we use the module's artifactId as the module directory's name</i>).</p>
<p>Now, whenever a Maven command processes com.mycompany.app:my-app:1, that same Maven command would be ran against com.mycompany.app:my-module:1 as well. Furthermore, some commands (goals specifically) handle project aggregation differently.</p>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p></section></section><section>
-<h3><a id="Example_4">Example 4</a></h3><section><a id="The_Scenario_3"></a>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p></section></section><section><a id="Example_4"></a>
+<h3>Example 4</h3><section><a id="The_Scenario_3"></a>
<h4>The Scenario</h4>
<p>But what if we change the directory structure to the following:</p>
<pre>.
@@ -349,8 +349,8 @@
<modules>
<module>../my-module</module>
</modules>
-</project></code></pre></section></section></section><section>
-<h2><a id="Project_Inheritance_vs_Project_Aggregation">Project Inheritance vs Project Aggregation</a></h2>
+</project></code></pre></section></section></section><section><a id="Project_Inheritance_vs_Project_Aggregation"></a>
+<h2>Project Inheritance vs Project Aggregation</h2>
<p>If you have several Maven projects, and they all have similar configurations, you can refactor your projects by pulling out those similar configurations and making a parent project. Thus, all you have to do is to let your Maven projects inherit that parent project, and those configurations would then be applied to all of them.</p>
<p>And if you have a group of projects that are built or processed together, you can create a parent project and have that parent project declare those projects as its modules. By doing so, you'd only have to build the parent and the rest will follow.</p>
<p>But of course, you can have both Project Inheritance and Project Aggregation. Meaning, you can have your modules specify a parent project, and at the same time, have that parent project specify those Maven projects as its modules. You'd just have to apply all three rules:</p>
@@ -358,8 +358,8 @@
<li>Specify in every child POM who their parent POM is.</li>
<li>Change the parent POMs packaging to the value "pom" .</li>
<li>Specify in the parent POM the directories of its modules (children POMs)</li></ul>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p><section>
-<h3><a id="Example_5">Example 5</a></h3><section><a id="The_Scenario_4"></a>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p><section><a id="Example_5"></a>
+<h3>Example 5</h3><section><a id="The_Scenario_4"></a>
<h4>The Scenario</h4>
<p>Given the previous original artifact POMs again,</p>
<p><b>com.mycompany.app:my-app:1's POM</b></p>
@@ -413,13 +413,13 @@
<artifactId>my-module</artifactId>
</project></code></pre>
<p><b>NOTE:</b> Profile inheritance the same inheritance strategy as used for the POM itself.</p>
-<p><a href="./introduction-to-the-pom.html">[top]</a></p></section></section></section><section>
-<h2><a id="Project_Interpolation">Project Interpolation</a> and Variables</h2>
+<p><a href="./introduction-to-the-pom.html">[top]</a></p></section></section></section><section><a id="Project_Interpolation_and_Variables"></a>
+<h2>Project Interpolation and Variables</h2>
<p>One of the practices that Maven encourages is <i>don't repeat yourself</i>. However, there are circumstances where you will need to use the same value in several different locations. To assist in ensuring the value is only specified once, Maven allows you to use both your own and pre-defined variables in the POM.</p>
<p>For example, to access the <code>project.version</code> variable, you would reference it like so:</p>
<pre class="prettyprint linenums"><code> <version>${project.version}</version></code></pre>
-<p>One factor to note is that these variables are processed <i>after</i> inheritance as outlined above. This means that if a parent project uses a variable, then its definition in the child, not the parent, will be the one eventually used.</p><section>
-<h3><a id="Available_Variables">Available Variables</a></h3><section><a id="Project_Model_Variables"></a>
+<p>One factor to note is that these variables are processed <i>after</i> inheritance as outlined above. This means that if a parent project uses a variable, then its definition in the child, not the parent, will be the one eventually used.</p><section><a id="Available_Variables"></a>
+<h3>Available Variables</h3><section><a id="Project_Model_Variables"></a>
<h4>Project Model Variables</h4>
<p>Any field of the model that is a single value element can be referenced as a variable. For example, <code>${project.groupId}</code>, <code>${project.version}</code>, <code>${project.build.sourceDirectory}</code> and so on. Refer to the POM reference to see a full list of properties.</p>
<p>These variables are all referenced by the prefix "<code>project.</code>". You may also see references with <code>pom.</code> as the prefix, or the prefix omitted entirely - these forms are now deprecated and should not be used.</p></section><section><a id="Special_Variables"></a>
Modified: maven/website/content/guides/introduction/introduction-to-the-standard-directory-layout.html
==============================================================================
--- maven/website/content/guides/introduction/introduction-to-the-standard-directory-layout.html (original)
+++ maven/website/content/guides/introduction/introduction-to-the-standard-directory-layout.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-the-standard-directory-layout.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/introduction/introduction-to-the-standard-directory-layout.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Introduction to the Standard Directory Layout <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/introduction/introduction-to-the-standard-directory-layout.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-3rd-party-jars-local.html
==============================================================================
--- maven/website/content/guides/mini/guide-3rd-party-jars-local.html (original)
+++ maven/website/content/guides/mini/guide-3rd-party-jars-local.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-3rd-party-jars-local.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-3rd-party-jars-local.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -49,7 +49,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to installing 3rd party JARs <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-3rd-party-jars-local.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-3rd-party-jars-remote.html
==============================================================================
--- maven/website/content/guides/mini/guide-3rd-party-jars-remote.html (original)
+++ maven/website/content/guides/mini/guide-3rd-party-jars-remote.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-3rd-party-jars-remote.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-3rd-party-jars-remote.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to deploying 3rd party JARs to remote repository <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-3rd-party-jars-remote.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-archive-configuration.html
==============================================================================
--- maven/website/content/guides/mini/guide-archive-configuration.html (original)
+++ maven/website/content/guides/mini/guide-archive-configuration.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-archive-configuration.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-archive-configuration.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Configuring Archive Plugins <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-archive-configuration.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-assemblies.html
==============================================================================
--- maven/website/content/guides/mini/guide-assemblies.html (original)
+++ maven/website/content/guides/mini/guide-assemblies.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-assemblies.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-assemblies.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Creating Assemblies <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-assemblies.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-attached-tests.html
==============================================================================
--- maven/website/content/guides/mini/guide-attached-tests.html (original)
+++ maven/website/content/guides/mini/guide-attached-tests.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-attached-tests.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-attached-tests.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to using attached tests <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-attached-tests.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-bash-m2-completion.html
==============================================================================
--- maven/website/content/guides/mini/guide-bash-m2-completion.html (original)
+++ maven/website/content/guides/mini/guide-bash-m2-completion.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-bash-m2-completion.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-bash-m2-completion.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -50,7 +50,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Maven auto completion using BASH <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-bash-m2-completion.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-building-for-different-environments.html
==============================================================================
--- maven/website/content/guides/mini/guide-building-for-different-environments.html (original)
+++ maven/website/content/guides/mini/guide-building-for-different-environments.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-building-for-different-environments.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-building-for-different-environments.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Building For Different Environments <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-building-for-different-environments.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-configuring-maven.html
==============================================================================
--- maven/website/content/guides/mini/guide-configuring-maven.html (original)
+++ maven/website/content/guides/mini/guide-configuring-maven.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-configuring-maven.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-configuring-maven.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Configuring Maven <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-configuring-maven.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-configuring-plugins.html
==============================================================================
--- maven/website/content/guides/mini/guide-configuring-plugins.html (original)
+++ maven/website/content/guides/mini/guide-configuring-plugins.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-configuring-plugins.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-configuring-plugins.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -49,7 +49,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Configuring Plug-ins <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-configuring-plugins.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
@@ -178,8 +178,8 @@
<li><b>Build plugins</b> are executed during the build and configured in the <code><build/></code> element.</li>
<li><b>Reporting plugins</b> are executed during the site generation and configured in the <code><reporting/></code> element.</li></ul>
<p>All plugins should have at least the minimal required <a href="/ref/current/maven-model/maven.html#class_plugin">information</a>: <code>groupId</code>, <code>artifactId</code> and <code>version</code>.</p>
-<p><b>Important Note</b>: Always define the version of each plugin used to guarantee build reproducibility. A good practice is to specify each build plugin's version in a <code><build><pluginManagement/></build></code> element. Often the <pluginManagement/> element is found in the parent POM. For reporting plugins, specify each version in the <code><reporting><plugins/></reporting></code> element (and in the <code><build><pluginManagement/></build></code> element too).</p></section><section>
-<h2><a id="Generic_Configuration">Generic Configuration</a></h2>
+<p><b>Important Note</b>: Always define the version of each plugin used to guarantee build reproducibility. A good practice is to specify each build plugin's version in a <code><build><pluginManagement/></build></code> element. Often the <pluginManagement/> element is found in the parent POM. For reporting plugins, specify each version in the <code><reporting><plugins/></reporting></code> element (and in the <code><build><pluginManagement/></build></code> element too).</p></section><section><a id="Generic_Configuration"></a>
+<h2>Generic Configuration</h2>
<p>Maven plugins (build and reporting) are configured by specifying a <code><configuration></code> element where the child elements of the <code><configuration></code> element are mapped to fields, or setters, inside your Mojo. (Remember that a plug-in consists of one or more Mojos where a Mojo maps to a goal.) Say, for example, you have a Mojo that performs a query against a particular URL, with a specified timeout and list of options. The Mojo might look like the following:</p>
<pre class="prettyprint linenums"><code>@Mojo( name = "query" )
public class MyQueryMojo
@@ -225,14 +225,14 @@ public class MyQueryMojo
<p>The elements in the configuration match the names of the fields in the Mojo. The mapping is straight forward. The <code>url</code> element maps to the <code>url</code> field, the <code>timeout</code> element maps to the <code>timeout</code> field, and the <code>options</code> element maps to the <code>options</code> field. The mapping mechanism can deal with arrays by inspecting the type of the field and determining if a suitable mapping is possible.</p>
<p>For Mojos that are intended to be executed directly from the CLI, their parameters usually provide a means to be configured via system properties instead of a <code><configuration></code> section in the POM. The plugin documentation for those parameters will list an <i>expression</i> that denotes the system properties for the configuration. In the Mojo above, the parameter <code>url</code> is associated with the expression <code>${query.url}</code>, meaning its value can be specified by the system property <code>query.url</code> as shown below:</p>
<pre>mvn myquery:query -Dquery.url=http://maven.apache.org</pre>
-<p>The name of the system property does not necessarily match the name of the mojo parameter. While this is a rather common practice, you will often notice plugins that employ some prefix for the system properties to avoid name clashes with other system properties. Though rarely, there are also plugin parameters that (e.g. for historical reasons) employ system properties which are completely unrelated to the parameter name. So be sure to have a close look at the plugin documentation.</p><section>
-<h3><a id="Help_Goal">Help Goal</a></h3>
+<p>The name of the system property does not necessarily match the name of the mojo parameter. While this is a rather common practice, you will often notice plugins that employ some prefix for the system properties to avoid name clashes with other system properties. Though rarely, there are also plugin parameters that (e.g. for historical reasons) employ system properties which are completely unrelated to the parameter name. So be sure to have a close look at the plugin documentation.</p><section><a id="Help_Goal"></a>
+<h3>Help Goal</h3>
<p>Most Maven plugins have a <code>help</code> goal that prints a description of the plugin and its parameters and types. For instance, to see help for the javadoc goal, type:</p>
<pre>mvn javadoc:help -Ddetail -Dgoal=javadoc</pre>
-<p>And you will see all parameters for the javadoc:javadoc goal, similar to this <a href="/plugins/maven-javadoc-plugin/javadoc-mojo.html">page</a>.</p></section><section>
-<h3><a id="Configuring_Parameters">Configuring Parameters</a></h3>
-<p>Parameterization of Mojos relies internally on the Plexus Component Configuration API provided by <a class="externalLink" href="https://github.com/eclipse/sisu.plexus">sisu-plexus</a>.</p><section>
-<h4><a id="Mapping_Value_Objects">Mapping Value Objects</a></h4>
+<p>And you will see all parameters for the javadoc:javadoc goal, similar to this <a href="/plugins/maven-javadoc-plugin/javadoc-mojo.html">page</a>.</p></section><section><a id="Configuring_Parameters"></a>
+<h3>Configuring Parameters</h3>
+<p>Parameterization of Mojos relies internally on the Plexus Component Configuration API provided by <a class="externalLink" href="https://github.com/eclipse/sisu.plexus">sisu-plexus</a>.</p><section><a id="Mapping_Value_Objects"></a>
+<h4>Mapping Value Objects</h4>
<p>Mapping value types, like Boolean or Integer, is very simple. The <code><configuration></code> element might look like the following:</p>
<pre class="prettyprint linenums"><code><project>
...
@@ -301,8 +301,8 @@ public class MyQueryMojo
<td style="text-align: center;"><a class="externalLink" href="https://docs.oracle.com/javase/8/docs/api/java/net/URI.html#URI-java.lang.String-"><code>new URI(String)</code></a></td></tr>
<tr class="b">
<td style="text-align: center;"><code>java.net.URL</code></td>
-<td style="text-align: center;"><a class="externalLink" href="https://docs.oracle.com/javase/8/docs/api/java/net/URL.html#URL-java.lang.String-"><code>new URL(String)</code></a></td></tr></table></section><section>
-<h4><a id="Mapping_Complex_Objects">Mapping Complex Objects</a></h4>
+<td style="text-align: center;"><a class="externalLink" href="https://docs.oracle.com/javase/8/docs/api/java/net/URL.html#URL-java.lang.String-"><code>new URL(String)</code></a></td></tr></table></section><section><a id="Mapping_Complex_Objects"></a>
+<h4>Mapping Complex Objects</h4>
<p>Mapping complex types is also fairly straight forward. Let's look at a simple example where we are trying to map a configuration for Person object. The <code><configuration/></code> element might look like the following:</p>
<pre class="prettyprint linenums"><code><project>
...
@@ -328,10 +328,10 @@ public class MyQueryMojo
</person>
</configuration>
...
-</project></code></pre></section><section>
-<h4><a id="Mapping_Collection_Types">Mapping Collection Types</a></h4>
-<p>The configuration mapping mechanism can easily deal with most collections so let's go through a few examples to show you how it's done:</p><section>
-<h5><a id="Mapping_Collections_and_Arrays">Mapping Collections and Arrays</a></h5>
+</project></code></pre></section><section><a id="Mapping_Collection_Types"></a>
+<h4>Mapping Collection Types</h4>
+<p>The configuration mapping mechanism can easily deal with most collections so let's go through a few examples to show you how it's done:</p><section><a id="Mapping_Collections_and_Arrays"></a>
+<h5>Mapping Collections and Arrays</h5>
<p>Mapping to collections works in much the same way as mapping to arrays. Each item is given in the XML as dedicated element. The element name does not matter in that case. So if you have a mojo like the following:</p>
<pre class="prettyprint linenums"><code>public class MyAnimalMojo
extends AbstractMojo
@@ -402,8 +402,8 @@ public class MyQueryMojo
</build>
...
</project></code></pre>
-<p>Each item is mapped again according to the rules of this section depending on the type of the collection/array.</p></section><section>
-<h5><a id="Mapping_Maps">Mapping Maps</a></h5>
+<p>Each item is mapped again according to the rules of this section depending on the type of the collection/array.</p></section><section><a id="Mapping_Maps"></a>
+<h5>Mapping Maps</h5>
<p>In the same way, you could define maps like the following:</p>
<pre class="prettyprint linenums"><code>...
@Parameter
@@ -421,8 +421,8 @@ public class MyQueryMojo
</project></code></pre>
<p>Unlike Collections the value type for Maps is always derived from the parameter type information from either <a class="externalLink" href="https://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Field.html#getGenericType()"><code>Field.getGenericType()</code></a> or <a class="externalLink" href="https://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html#getGenericParameterTypes()"><code>Method.getGenericParameterTypes()</code></a>. It falls back to <code>String</code>. The key type must always be <code>String</code>.</p>
<p>In contrast to value objects and collections/arrays there is no string coercion defined for maps, i.e. you cannot give parameters of that type via CLI argument. </p>
-<p>The map implementation class is by default <code>TreeMap</code> but can be overridden with an <code>implementation</code> attribute on the XML element representing the map.</p></section><section>
-<h5><a id="Mapping_Properties">Mapping Properties</a></h5>
+<p>The map implementation class is by default <code>TreeMap</code> but can be overridden with an <code>implementation</code> attribute on the XML element representing the map.</p></section><section><a id="Mapping_Properties"></a>
+<h5>Mapping Properties</h5>
<p>Properties should be defined like the following:</p>
<pre class="prettyprint linenums"><code>...
@Parameter
@@ -444,10 +444,10 @@ public class MyQueryMojo
</configuration>
...
</project></code></pre>
-<p>In contrast to value objects and collections/arrays there is no string coercion defined for properties, i.e. you cannot give parameters of those type via CLI argument. </p></section></section></section></section><section>
-<h2><a id="Configuring_Build_Plugins">Configuring Build Plugins</a></h2>
-<p>The following is only to configure Build plugins in the <code><build></code> element.</p><section>
-<h3><a id="Using_the_.3Cexecutions.3E_Tag">Using the <code><executions></code> Tag</a></h3>
+<p>In contrast to value objects and collections/arrays there is no string coercion defined for properties, i.e. you cannot give parameters of those type via CLI argument. </p></section></section></section></section><section><a id="Configuring_Build_Plugins"></a>
+<h2>Configuring Build Plugins</h2>
+<p>The following is only to configure Build plugins in the <code><build></code> element.</p><section><a id="Using_the_.3Cexecutions.3E_Tag"></a>
+<h3>Using the <code><executions></code> Tag</h3>
<p>You can also configure a mojo using the <code><executions></code> tag. This is most commonly used for mojos that are intended to participate in some phases of the <a href="../introduction/introduction-to-the-lifecycle.html">build lifecycle</a>. Using <code>MyQueryMojo</code> as an example, you may have something that will look like:</p>
<pre class="prettyprint linenums"><code><project>
...
@@ -585,8 +585,8 @@ public class MyBoundQueryMojo
</project></code></pre>
<p>Now, <code>MyBoundQueryMojo</code> default phase which is package has been overridden by install phase.</p>
<p><b>Note:</b> Configurations inside the <code><executions></code> element used to differ from those that are outside <code><executions></code> in that they could not be used from a direct command line invocation because they were only applied when the lifecycle phase they were bound to was invoked. So you had to move a configuration section outside of the executions section to apply it globally to all invocations of the plugin. Since Maven 3.3.1 this is not the case anymore as you can specify on the command line the execution id for direct plugin goal invocation. Hence if you want to run the above plugin and it's specific execution1's configuration from the command-line, you can execute:</p>
-<pre>mvn myquery:query@execution1</pre></section><section>
-<h3><a id="Using_the_.3Cdependencies.3E_Tag">Using the <code><dependencies></code> Tag</a></h3>
+<pre>mvn myquery:query@execution1</pre></section><section><a id="Using_the_.3Cdependencies.3E_Tag"></a>
+<h3>Using the <code><dependencies></code> Tag</h3>
<p>You could configure the dependencies of the Build plugins, commonly to use a more recent dependency version.</p>
<p>For instance, the Maven Antrun Plugin version 1.2 uses Ant version 1.6.5, if you want to use the latest Ant version when running this plugin, you need to add <code><dependencies></code> element like the following:</p>
<pre class="prettyprint linenums"><code><project>
@@ -614,8 +614,8 @@ public class MyBoundQueryMojo
</plugins>
</build>
...
-</project></code></pre></section><section>
-<h3><a id="Using_the_.3Cinherited.3E_Tag_In_Build_Plugins">Using the <code><inherited></code> Tag In Build Plugins</a></h3>
+</project></code></pre></section><section><a id="Using_the_.3Cinherited.3E_Tag_In_Build_Plugins"></a>
+<h3>Using the <code><inherited></code> Tag In Build Plugins</h3>
<p>By default, plugin configuration should be propagated to child POMs, so to break the inheritance, you could use the <code><inherited></code> tag:</p>
<pre class="prettyprint linenums"><code><project>
...
@@ -631,17 +631,17 @@ public class MyBoundQueryMojo
</plugins>
</build>
...
-</project></code></pre></section></section><section>
-<h2><a id="Configuring_Reporting_Plugins">Configuring Reporting Plugins</a></h2>
-<p>The following is only to configure Reporting plugins in the <code><reporting></code> element.</p><section>
-<h3><a id="Using_the_.3Creporting.3E_Tag_VS_.3Cbuild.3E_Tag">Using the <code><reporting></code> Tag VS <code><build></code> Tag</a></h3>
+</project></code></pre></section></section><section><a id="Configuring_Reporting_Plugins"></a>
+<h2>Configuring Reporting Plugins</h2>
+<p>The following is only to configure Reporting plugins in the <code><reporting></code> element.</p><section><a id="Using_the_.3Creporting.3E_Tag_VS_.3Cbuild.3E_Tag"></a>
+<h3>Using the <code><reporting></code> Tag VS <code><build></code> Tag</h3>
<p>Configuring a reporting plugin in the <code><reporting></code> or <code><build></code> elements in the pom does not exactly have the same results.</p>
<dl>
<dt><code>mvn site</code></dt>
<dd>Since maven-site-plugin 3.4, it uses the parameters defined in the <code><configuration></code> element of each reporting Plugin specified in the <code><reporting></code> element, in addition to the parameters defined in the <code><configuration></code> element of each plugin specified in <code><build></code> (parameters from <code><build></code> section were previously ignored).</dd>
<dt><code>mvn aplugin:areportgoal</code></dt>
-<dd>It <b>ignores</b> the parameters defined in the <code><configuration></code> element of each reporting Plugin specified in the <code><reporting></code> element; only parameters defined in the <code><configuration></code> element of each plugin specified in <code><build></code> are used.</dd></dl></section><section>
-<h3><a id="Using_the_.3CreportSets.3E_Tag">Using the <code><reportSets></code> Tag</a></h3>
+<dd>It <b>ignores</b> the parameters defined in the <code><configuration></code> element of each reporting Plugin specified in the <code><reporting></code> element; only parameters defined in the <code><configuration></code> element of each plugin specified in <code><build></code> are used.</dd></dl></section><section><a id="Using_the_.3CreportSets.3E_Tag"></a>
+<h3>Using the <code><reportSets></code> Tag</h3>
<p>You can configure a reporting plugin using the <code><reportSets></code> tag. This is most commonly used to generate reports selectively when running <code>mvn site</code>. The following will generate only the project team report.</p>
<pre class="prettyprint linenums"><code><project>
...
@@ -671,8 +671,8 @@ public class MyBoundQueryMojo
<reports/>
</reportSet>
</reportSets></code></pre></li>
-<li>Refer to each Plugin Documentation (i.e. plugin-info.html) to know the available report goals.</li></ol></section><section>
-<h3><a id="Using_the_.3Cinherited.3E_Tag_In_Reporting_Plugins">Using the <code><inherited></code> Tag In Reporting Plugins</a></h3>
+<li>Refer to each Plugin Documentation (i.e. plugin-info.html) to know the available report goals.</li></ol></section><section><a id="Using_the_.3Cinherited.3E_Tag_In_Reporting_Plugins"></a>
+<h3>Using the <code><inherited></code> Tag In Reporting Plugins</h3>
<p>Similar to the build plugins, to break the inheritance, you can use the <code><inherited></code> tag:</p>
<pre class="prettyprint linenums"><code><project>
...
Modified: maven/website/content/guides/mini/guide-creating-archetypes.html
==============================================================================
--- maven/website/content/guides/mini/guide-creating-archetypes.html (original)
+++ maven/website/content/guides/mini/guide-creating-archetypes.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-creating-archetypes.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-creating-archetypes.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Creating Archetypes <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-creating-archetypes.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-default-execution-ids.html
==============================================================================
--- maven/website/content/guides/mini/guide-default-execution-ids.html (original)
+++ maven/website/content/guides/mini/guide-default-execution-ids.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-default-execution-ids.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-default-execution-ids.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Configuring Default Mojo Executions <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-default-execution-ids.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-deployment-security-settings.html
==============================================================================
--- maven/website/content/guides/mini/guide-deployment-security-settings.html (original)
+++ maven/website/content/guides/mini/guide-deployment-security-settings.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-deployment-security-settings.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-deployment-security-settings.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Deployment and Security Settings <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-deployment-security-settings.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-encryption.html
==============================================================================
--- maven/website/content/guides/mini/guide-encryption.html (original)
+++ maven/website/content/guides/mini/guide-encryption.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-encryption.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-encryption.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -49,7 +49,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Password Encryption <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-encryption.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
@@ -160,13 +160,18 @@
<main id="bodyColumn" class="span10">
<section>
<h1><a id="Password_Encryption">Password Encryption</a></h1>
-<ol style="list-style-type: decimal;">
+<ul>
<li><a href="#Introduction">Introduction</a></li>
<li><a href="#How_to_create_a_master_password">How to create a master password</a></li>
<li><a href="#How_to_encrypt_server_passwords">How to encrypt server passwords</a></li>
<li><a href="#How_to_keep_the_master_password_on_removable_drive">How to keep the master password on removable drive</a></li>
-<li><a href="#Tips">Tips</a></li></ol><section>
-<h2><a id="Introduction">Introduction</a></h2>
+<li><a href="#Tips">Tips</a>
+<ul>
+<li><a href="#Escaping_curly-brace_literals_in_your_password_.28Since.3A_Maven_2.2.0.29">Escaping curly-brace literals in your password (Since: Maven 2.2.0)</a></li>
+<li><a href="#Password_Security">Password Security</a></li>
+<li><a href="#Password_Escaping_on_different_platforms">Password Escaping on different platforms</a></li>
+<li><a href="#Prompting_for_Password">Prompting for Password</a></li></ul></li></ul><section><a id="Introduction"></a>
+<h2>Introduction</h2>
<p>Maven supports server password encryption. The main use case, addressed by this solution is:</p>
<ul>
<li>multiple users share the same build machine (server, CI box)</li>
@@ -183,8 +188,8 @@
<li>this password is created first via CLI for now</li></ul></li>
<li>server entries in the <code>settings.xml</code> have passwords and/or keystore passphrases encrypted
<ul>
-<li>for now - this is done via CLI <b>after</b> master password has been created and stored in appropriate location</li></ul></li></ul></section><section>
-<h2><a id="How_to_create_a_master_password">How to create a master password</a></h2>
+<li>for now - this is done via CLI <b>after</b> master password has been created and stored in appropriate location</li></ul></li></ul></section><section><a id="How_to_create_a_master_password"></a>
+<h2>How to create a master password</h2>
<p>Use the following command line:</p>
<pre>mvn --encrypt-master-password <password></pre>
<p><i>Note:</i> Since Maven 3.2.1 the password argument should no longer be used (see <a href="#Tips">Tips</a> below for more information). Maven will prompt for the password. Earlier versions of Maven will not prompt for a password, so it must be typed on the command-line in plaintext.</p>
@@ -194,8 +199,8 @@
<pre class="prettyprint linenums"><code><settingsSecurity>
<master>{jSMOWnoPFgsHVpMvz5VrIt5kRbzGpI8u+9EF1iFQyJQ=}</master>
</settingsSecurity></code></pre>
-<p>When this is done, you can start encrypting existing server passwords.</p></section><section>
-<h2><a id="How_to_encrypt_server_passwords">How to encrypt server passwords</a></h2>
+<p>When this is done, you can start encrypting existing server passwords.</p></section><section><a id="How_to_encrypt_server_passwords"></a>
+<h2>How to encrypt server passwords</h2>
<p>You have to use the following command line:</p>
<pre>mvn --encrypt-password <password></pre>
<p><i>Note:</i>Just like <code>--encrypt-master-password</code> the password argument should no longer be used since Maven 3.2.1 (see <a href="#Tips">Tips below for more information.</a>).</p>
@@ -232,8 +237,8 @@
<p>Then you can use, say, deploy plugin, to write to this server:</p>
<pre>mvn deploy:deploy-file -Durl=https://maven.corp.com/repo \
-DrepositoryId=my.server \
- -Dfile=your-artifact-1.0.jar \</pre></section><section>
-<h2><a id="How_to_keep_the_master_password_on_removable_drive">How to keep the master password on removable drive</a></h2>
+ -Dfile=your-artifact-1.0.jar \</pre></section><section><a id="How_to_keep_the_master_password_on_removable_drive"></a>
+<h2>How to keep the master password on removable drive</h2>
<p>Create the master password exactly as described above, and store it on a removable drive, for instance on OSX, my USB drive mounts as <code>/Volumes/mySecureUsb</code>, so I store</p>
<pre class="prettyprint linenums"><code><settingsSecurity>
<master>{jSMOWnoPFgsHVpMvz5VrIt5kRbzGpI8u+9EF1iFQyJQ=}</master>
@@ -243,8 +248,8 @@
<pre class="prettyprint linenums"><code><settingsSecurity>
<relocation>/Volumes/mySecureUsb/secure/settings-security.xml</relocation>
</settingsSecurity></code></pre>
-<p>This assures that encryption only works when the USB drive is mounted by the OS. This addresses a use case where only certain people are authorized to deploy and are issued these devices.</p></section><section>
-<h2><a id="Tips">Tips</a></h2><section><a id="Escaping_curly-brace_literals_in_your_password_.28Since.3A_Maven_2.2.0.29"></a>
+<p>This assures that encryption only works when the USB drive is mounted by the OS. This addresses a use case where only certain people are authorized to deploy and are issued these devices.</p></section><section><a id="Tips"></a>
+<h2>Tips</h2><section><a id="Escaping_curly-brace_literals_in_your_password_.28Since.3A_Maven_2.2.0.29"></a>
<h3>Escaping curly-brace literals in your password <i>(Since: Maven 2.2.0)</i></h3>
<p>At times, you might find that your password (or the encrypted form of it) contains '{' or '}' as a literal value. If you added such a password as-is to your settings.xml file, you would find that Maven does strange things with it. Specifically, Maven treats all the characters preceding the '{' literal, and all the characters after the '}' literal, as comments. Obviously, this is not the behavior you want. What you really need is a way of <b>escaping</b> the curly-brace literals in your password.</p>
<p>You can do this with the widely used '\' escape character. If your password looks like this:</p>
Modified: maven/website/content/guides/mini/guide-generating-sources.html
==============================================================================
--- maven/website/content/guides/mini/guide-generating-sources.html (original)
+++ maven/website/content/guides/mini/guide-generating-sources.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-generating-sources.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-generating-sources.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -50,7 +50,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to generating Sources <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-generating-sources.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>
Modified: maven/website/content/guides/mini/guide-http-settings.html
==============================================================================
--- maven/website/content/guides/mini/guide-http-settings.html (original)
+++ maven/website/content/guides/mini/guide-http-settings.html Sun Dec 29 13:41:19 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-http-settings.apt at 2024-12-27
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/guides/mini/guide-http-settings.apt at 2024-12-29
| Rendered using Apache Maven Fluido Skin 2.0.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -48,7 +48,7 @@
<li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
<li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
<li class="active">Guide to Advanced Wagon Transport Configuration <a href="https://github.com/apache/maven-site/tree/master/content/apt/guides/mini/guide-http-settings.apt"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-27</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-12-29</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi">Download</a></li>