You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2020/06/06 10:34:26 UTC
[maven-site] branch master updated: formatting
This is an automated email from the ASF dual-hosted git repository.
hboutemy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git
The following commit(s) were added to refs/heads/master by this push:
new 72d7a2a formatting
72d7a2a is described below
commit 72d7a2a90c736a408591d4672c3ef16c4a5ba8fd
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Sat Jun 6 12:34:22 2020 +0200
formatting
---
.../introduction/introduction-to-the-pom.apt | 44 +++++++++++++++-------
content/apt/run-maven/index.apt | 8 ++--
2 files changed, 35 insertions(+), 17 deletions(-)
diff --git a/content/apt/guides/introduction/introduction-to-the-pom.apt b/content/apt/guides/introduction/introduction-to-the-pom.apt
index c07641d..90b2b46 100644
--- a/content/apt/guides/introduction/introduction-to-the-pom.apt
+++ b/content/apt/guides/introduction/introduction-to-the-pom.apt
@@ -84,9 +84,9 @@ Introduction to the POM
* {Super POM}
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. The snippet below is the Super POM for Maven 3.5.4.
+ in the Super POM is inherited by the POMs you created for your projects.
-%{snippet|id=superpom|url=https://raw.githubusercontent.com/apache/maven/maven-3.5.4/maven-model-builder/src/main/resources/org/apache/maven/model/pom-4.0.0.xml}
+ You can see the {{{/ref/3.6.3/maven-model-builder/super-pom.html}Super POM for Maven 3.6.3}} in Maven Core reference documentation.
{{{./introduction-to-the-pom.html}[top]}}
@@ -94,15 +94,15 @@ Introduction to the POM
The minimum requirement for a POM are the following:
- * project root
+ * <<<project>>> root
- * modelVersion - should be set to 4.0.0
+ * <<<modelVersion>>> - should be set to 4.0.0
- * groupId - the id of the project's group.
+ * <<<groupId>>> - the id of the project's group.
- * artifactId - the id of the artifact (project)
+ * <<<artifactId>>> - the id of the artifact (project)
- * version - the version of the artifact under the specified group
+ * <<<version>>> - the version of the artifact under the specified group
[]
@@ -111,6 +111,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
@@ -165,6 +166,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-module</artifactId>
<version>1</version>
@@ -173,12 +175,12 @@ Introduction to the POM
And let us specify their directory structure as the following:
-+-----+
+-----
.
|-- my-module
| `-- pom.xml
`-- pom.xml
-+-----+
+-----
<<Note:>> <<<my-module/pom.xml>>> is the POM of com.mycompany.app:my-module:1 while <<<pom.xml>>> is the POM of
com.mycompany.app:my-app:1
@@ -192,12 +194,14 @@ Introduction to the POM
+-----+
<project>
+ <modelVersion>4.0.0</modelVersion>
+
<parent>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
</parent>
- <modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-module</artifactId>
<version>1</version>
@@ -213,12 +217,14 @@ Introduction to the POM
+-----+
<project>
+ <modelVersion>4.0.0</modelVersion>
+
<parent>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
</parent>
- <modelVersion>4.0.0</modelVersion>
+
<artifactId>my-module</artifactId>
</project>
+-----+
@@ -251,13 +257,15 @@ Introduction to the POM
+-----+
<project>
+ <modelVersion>4.0.0</modelVersion>
+
<parent>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
<relativePath>../parent/pom.xml</relativePath>
</parent>
- <modelVersion>4.0.0</modelVersion>
+
<artifactId>my-module</artifactId>
</project>
+-----+
@@ -290,6 +298,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
@@ -301,6 +310,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-module</artifactId>
<version>1</version>
@@ -323,6 +333,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
@@ -368,6 +379,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
@@ -414,6 +426,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
@@ -425,6 +438,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-module</artifactId>
<version>1</version>
@@ -450,6 +464,7 @@ Introduction to the POM
+-----+
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
@@ -465,13 +480,15 @@ Introduction to the POM
+-----+
<project>
+ <modelVersion>4.0.0</modelVersion>
+
<parent>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1</version>
<relativePath>../parent/pom.xml</relativePath>
</parent>
- <modelVersion>4.0.0</modelVersion>
+
<artifactId>my-module</artifactId>
</project>
+-----+
@@ -539,6 +556,7 @@ Introduction to the POM
<properties>
<mavenVersion>3.0</mavenVersion>
</properties>
+
<dependencies>
<dependency>
<groupId>org.apache.maven</groupId>
diff --git a/content/apt/run-maven/index.apt b/content/apt/run-maven/index.apt
index 7735f20..43bde55 100644
--- a/content/apt/run-maven/index.apt
+++ b/content/apt/run-maven/index.apt
@@ -58,7 +58,7 @@ mvn verify
A missing dependency presents with an error like the following:
-+-----+
+-----
[INFO] Failed to resolve artifact.
Missing:
@@ -83,7 +83,7 @@ for artifact:
from the specified remote repositories:
central (https://repo.maven.apache.org/maven2)
-+-----+
+-----
To resolve this issue, it depends on what the dependency is and why it is missing. The most common cause is because
it can not be redistributed from the repository and must be manually installed using the instructions given in the
@@ -99,8 +99,8 @@ from the specified remote repositories:
** Inconsistent output
- Most plugins are optimized to know if they have to execute their task. In some cases the output can be polluted from
- a previous build and the end result is not what you expected. In such rare situations you can call the <<<clean>>> phase
+ Most plugins are optimized to know if they have to execute their task. In some cases, the output can be polluted from
+ a previous build and the end result is not what you expected. In such rare situations, you can call the <<<clean>>> phase
which means: remove the output directory.
You can also call it as <<<mvn clean verify>>> which means: first clean up the output directory, next build the project
and verify the outcome.