You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/08/06 13:17:44 UTC
(maven-artifact-plugin) 02/02: Port the site documentation from APT to Markdown
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-artifact-plugin.git
commit 49d4bb4918ac3b27e9f62d5c31d77bfbe93e36d6
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Thu Aug 6 13:53:00 2026 +0200
Port the site documentation from APT to Markdown
4 page(s) converted with doxia-converter and then cleaned up by hand:
- <<<code>>> becomes backticks, <<bold>> becomes **bold**, {{{url}text}}
becomes [text](url)
- the ASF license header becomes a single block HTML comment
- a page whose only Velocity reference was ${project.name} is now a plain
.md with the title spelled out
- a page that keeps a reference stays a .vm. Velocity reads ## as a line
comment and would silently swallow every ATX heading below level one, so
subsections use setext underlines and anything deeper is wrapped in
#[[ ... ]]#
- references APT rendered literally are escaped, so they do not resolve
Verified by building the site before and after and comparing every
generated page: the visible text and the link targets are unchanged apart
from <b>/<i> becoming <strong>/<em> and quotes in prose picking up the
Markdown module's typographic substitution.
---
src/site/markdown/index.md | 92 +++++++------------
src/site/markdown/reproducible.md.vm | 170 ++++++++++++++++-------------------
src/site/markdown/usage.md.vm | 65 ++++++--------
3 files changed, 138 insertions(+), 189 deletions(-)
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index c0bea2e..c889b54 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,72 +1,44 @@
- ------
- Introduction
- ------
- Hervé Boutemy
- ------
- 2020-06-20
- ------
+<!--
+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
-~~ 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.
+http://www.apache.org/licenses/LICENSE-2.0
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+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.
+-->
-${project.name}
+# Apache Maven Artifact Plugin
+The Artifact Plugin is used to manage artifacts tasks.
- The Artifact Plugin is used to manage artifacts tasks.
+## Goals Overview
-* Goals Overview
+The Artifact Plugin has 4 goals currently:
- The Artifact Plugin has 4 goals currently:
+- [artifact:buildinfo](./buildinfo-mojo.html) records current build results (from `package`) in [Reproducible Builds buildinfo](https://reproducible-builds.org/docs/jvm/) file,
+- [artifact:compare](./compare-mojo.html) compares current build output (from `package`) against reference build previously published,
+- [artifact:check-buildplan](./check-buildplan-mojo.html) checks the project's buildplan to find if any used [plugin has a known Reproducible Builds issue](./plugin-issues.html),
+- [artifact:describe-build-output](./describe-build-output-mojo.html) (experimental) describes build structure and output,
+- [artifact:reproducible-central](./reproducible-central-mojo.html) (experimental) report shows if dependencies are proven Reproducible Builds at Reproducible Central.
+## Usage
- * {{{./buildinfo-mojo.html}artifact:buildinfo}} records current build results (from <<<package>>>) in {{{https://reproducible-builds.org/docs/jvm/}Reproducible Builds buildinfo}} file,
+General instructions on how to use the Artifact Plugin can be found on the [usage page](./usage.html). Some more specific use cases are described in the examples given below.
- * {{{./compare-mojo.html}artifact:compare}} compares current build output (from <<<package>>>) against reference build previously published,
+In case you still have questions regarding the plugin's usage, please have a look at the [FAQ](./faq.html) and feel free to contact the [user mailing list](./mailing-lists.html). The posts to the mailing list are archived and could already contain the answer to your question as part of an older thread. Hence, it is also worth browsing/searching the [mail archive](./mailing-lists.html).
- * {{{./check-buildplan-mojo.html}artifact:check-buildplan}} checks the project's buildplan to find if any used {{{./plugin-issues.html}plugin has a known Reproducible Builds issue}},
+If you feel like the plugin is missing a feature or has a defect, you can fill a feature request or bug report in our [issue tracker](./issue-management.html). When creating a new issue, please provide a comprehensive description of your concern. Especially for fixing bugs it is crucial that the developers can reproduce your problem. For this reason, entire debug logs, POMs or most preferably little demo projects attached to the issue are very much appreciated. Of course, patches are wel [...]
- * {{{./describe-build-output-mojo.html}artifact:describe-build-output}} (experimental) describes build structure and output,
+## Examples
- * {{{./reproducible-central-mojo.html}artifact:reproducible-central}} (experimental) report shows if dependencies are proven Reproducible Builds at Reproducible Central.
+To provide you with better understanding on some usages of the Artifact Plugin, you can take a look into the following examples:
-* Usage
-
- General instructions on how to use the Artifact Plugin can be found on the {{{./usage.html}usage page}}. Some more
- specific use cases are described in the examples given below.
-
- In case you still have questions regarding the plugin's usage, please have a look at the {{{./faq.html}FAQ}} and feel
- free to contact the {{{./mailing-lists.html}user mailing list}}. The posts to the mailing list are archived and could
- already contain the answer to your question as part of an older thread. Hence, it is also worth browsing/searching
- the {{{./mailing-lists.html}mail archive}}.
-
- If you feel like the plugin is missing a feature or has a defect, you can fill a feature request or bug report in our
- {{{./issue-management.html}issue tracker}}. When creating a new issue, please provide a comprehensive description of your
- concern. Especially for fixing bugs it is crucial that the developers can reproduce your problem. For this reason,
- entire debug logs, POMs or most preferably little demo projects attached to the issue are very much appreciated.
- Of course, patches are welcome, too. Contributors can check out the project from our
- {{{./scm.html}source repository}} and will find supplementary information in the
- {{{http://maven.apache.org/guides/development/guide-helping.html}guide to helping with Maven}}.
-
-* Examples
-
- To provide you with better understanding on some usages of the Artifact Plugin,
- you can take a look into the following examples:
-
- * {{{./reproducible.html}How to diagnose issues with Reproducible Builds?}}
-
- []
+- [How to diagnose issues with Reproducible Builds?](./reproducible.html)
diff --git a/src/site/markdown/reproducible.md.vm b/src/site/markdown/reproducible.md.vm
index 0406e4b..07305ee 100644
--- a/src/site/markdown/reproducible.md.vm
+++ b/src/site/markdown/reproducible.md.vm
@@ -1,36 +1,27 @@
- ------
- Diagnosing Reproducible Build Issue
- ------
- Hervé Boutemy
- ------
- 2020-06-20
- ------
+<!--
+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
-~~ 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.
+http://www.apache.org/licenses/LICENSE-2.0
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+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.
+-->
-Diagnosing Reproducible Build Issues
+# Diagnosing Reproducible Build Issues
- When checking Reproducible Build, you may find that the current build output is not the same as the reference:
+When checking Reproducible Build, you may find that the current build output is not the same as the reference:
--------
+```
$ mvn -Papache-release clean verify -Dgpg.skip artifact:compare
[INFO] Scanning for projects...
...
@@ -53,74 +44,67 @@ Downloading from central: https://repo.maven.apache.org/maven2/org/apache/maven/
[INFO] Reproducible Build output comparison saved to /tmp/doxia-1.9.1/doxia-modules/doxia-module-markdown/target/doxia-module-markdown-1.9.1.buildcompare
[INFO] Aggregate buildcompare copied to /tmp/doxia-1.9.1/target/doxia-1.9.1.buildcompare
...
--------
+```
- Multiple interesting parts are available:
-
- * the summary: <<<[WARNING] Reproducible Build output summary: 39 files ok, 18 different>>>
+Multiple interesting parts are available:
- * key information on reference build environment:\
- <<<[INFO] Reference build java.version: 1.8 (from MANIFEST.MF Build-Jdk-Spec)>>>\
- <<<[INFO] Reference build os.name: Unix (from pom.properties newline)>>>\
+- the summary: `[WARNING] Reproducible Build output summary: 39 files ok, 18 different`
+- key information on reference build environment:
+ `[INFO] Reference build java.version: 1.8 (from MANIFEST.MF Build-Jdk-Spec)`
+ `[INFO] Reference build os.name: Unix (from pom.properties newline)`
which are the key requirements (JDK major version and Operating System) for the build environment to reproduce the reference build
+- eventual mismatch with current build environment:
+ `[ERROR] Current build java.version: 1.7 (from MANIFEST.MF Build-Jdk-Spec)`
+- on each artifact different from reference, a command is provided to investigate differences using [diffoscope tool](https://diffoscope.org/), a diff tool working inside archives (jar, zip, tar, ...):
+ simply copy paste provided command like `diffoscope target/reference/doxia-logging-api-1.9.1.jar doxia-logging-api/target/doxia-logging-api-1.9.1.jar` and you'll see where differences are:
- * eventual mismatch with current build environment:\
- <<<[ERROR] Current build java.version: 1.7 (from MANIFEST.MF Build-Jdk-Spec)>>>
+ ```shell
+ $ diffoscope target/reference/doxia-logging-api-1.9.1.jar doxia-logging-api/target/doxia-logging-api-1.9.1.jar
+ --- target/reference/doxia-logging-api-1.9.1.jar
+ +++ doxia-logging-api/target/doxia-logging-api-1.9.1.jar
+ ├── zipinfo /dev/stdin
+ │ @@ -1,8 +1,8 @@
+ │ -Zip file size: 11516 bytes, number of entries: 19
+ │ +Zip file size: 11497 bytes, number of entries: 19
+ │ -rw-r--r-- 2.0 unx 337 b- defN 20-Feb-13 21:11 META-INF/MANIFEST.MF
+ │ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 META-INF/
+ │ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/
+ │ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/
+ │ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/maven/
+ │ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/maven/doxia/
+ │ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/maven/doxia/logging/
+ │ @@ -11,11 +11,11 @@
+ │ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 META-INF/maven/org.apache.maven.doxia/doxia-logging-api/
+ │ -rw-r--r-- 2.0 unx 1641 b- defN 20-Feb-13 21:11 META-INF/DEPENDENCIES
+ │ -rw-r--r-- 2.0 unx 11358 b- defN 20-Feb-13 21:11 META-INF/LICENSE
+ │ -rw-r--r-- 2.0 unx 177 b- defN 20-Feb-13 21:11 META-INF/NOTICE
+ │ -rw-r--r-- 2.0 unx 716 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/Log.class
+ │ -rw-r--r-- 2.0 unx 198 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/LogEnabled.class
+ │ -rw-r--r-- 2.0 unx 2840 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/PlexusLoggerWrapper.class
+ │ --rw-r--r-- 2.0 unx 4208 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/SystemStreamLog.class
+ │ +-rw-r--r-- 2.0 unx 4192 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/SystemStreamLog.class
+ │ -rw-r--r-- 2.0 unx 1539 b- defN 20-Feb-13 21:11 META-INF/maven/org.apache.maven.doxia/doxia-logging-api/pom.xml
+ │ -rw-r--r-- 2.0 unx 74 b- defN 20-Feb-13 21:11 META-INF/maven/org.apache.maven.doxia/doxia-logging-api/pom.properties
+ │ -19 files, 23088 bytes uncompressed, 8842 bytes compressed: 61.7%
+ │ +19 files, 23072 bytes uncompressed, 8823 bytes compressed: 61.8%
+ ├── META-INF/MANIFEST.MF
+ │ @@ -1,10 +1,10 @@
+ │ Manifest-Version: 1.0
+ │ +Implementation-Vendor: The Apache Software Foundation
+ │ Implementation-Title: Doxia :: Logging API
+ │ Implementation-Version: 1.9.1
+ │ +Build-Jdk-Spec: 1.7
+ │ Specification-Vendor: The Apache Software Foundation
+ │ -Specification-Title: Doxia :: Logging API
+ │ -Build-Jdk-Spec: 1.8
+ │ Created-By: Maven Jar Plugin 3.2.0
+ │ +Specification-Title: Doxia :: Logging API
+ │ Specification-Version: 1.9
+ │ -Implementation-Vendor: The Apache Software Foundation
+ ├── org/apache/maven/doxia/logging/PlexusLoggerWrapper.class
+ ...
+ ```
- * on each artifact different from reference, a command is provided to investigate differences using {{{https://diffoscope.org/}diffoscope tool}}, a diff tool working inside archives (jar, zip, tar, ...):\
- simply copy paste provided command like <<<diffoscope target/reference/doxia-logging-api-1.9.1.jar doxia-logging-api/target/doxia-logging-api-1.9.1.jar>>> and you'll see where differences are:
+In this example, reference build was done with JDK 8 (see `│ -Build-Jdk-Spec: 1.8`), but the current build was done with JDK 7 (see `│ +Build-Jdk-Spec: 1.7`): this explains both difference in content of `META-INF/MANIFEST.MF` of every .jar file, but also of some bytecode in `.class` files.
-+----------
-$ diffoscope target/reference/doxia-logging-api-1.9.1.jar doxia-logging-api/target/doxia-logging-api-1.9.1.jar
---- target/reference/doxia-logging-api-1.9.1.jar
-+++ doxia-logging-api/target/doxia-logging-api-1.9.1.jar
-├── zipinfo /dev/stdin
-│ @@ -1,8 +1,8 @@
-│ -Zip file size: 11516 bytes, number of entries: 19
-│ +Zip file size: 11497 bytes, number of entries: 19
-│ -rw-r--r-- 2.0 unx 337 b- defN 20-Feb-13 21:11 META-INF/MANIFEST.MF
-│ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 META-INF/
-│ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/
-│ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/
-│ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/maven/
-│ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/maven/doxia/
-│ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 org/apache/maven/doxia/logging/
-│ @@ -11,11 +11,11 @@
-│ drwxr-xr-x 2.0 unx 0 b- stor 20-Feb-13 21:11 META-INF/maven/org.apache.maven.doxia/doxia-logging-api/
-│ -rw-r--r-- 2.0 unx 1641 b- defN 20-Feb-13 21:11 META-INF/DEPENDENCIES
-│ -rw-r--r-- 2.0 unx 11358 b- defN 20-Feb-13 21:11 META-INF/LICENSE
-│ -rw-r--r-- 2.0 unx 177 b- defN 20-Feb-13 21:11 META-INF/NOTICE
-│ -rw-r--r-- 2.0 unx 716 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/Log.class
-│ -rw-r--r-- 2.0 unx 198 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/LogEnabled.class
-│ -rw-r--r-- 2.0 unx 2840 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/PlexusLoggerWrapper.class
-│ --rw-r--r-- 2.0 unx 4208 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/SystemStreamLog.class
-│ +-rw-r--r-- 2.0 unx 4192 b- defN 20-Feb-13 21:11 org/apache/maven/doxia/logging/SystemStreamLog.class
-│ -rw-r--r-- 2.0 unx 1539 b- defN 20-Feb-13 21:11 META-INF/maven/org.apache.maven.doxia/doxia-logging-api/pom.xml
-│ -rw-r--r-- 2.0 unx 74 b- defN 20-Feb-13 21:11 META-INF/maven/org.apache.maven.doxia/doxia-logging-api/pom.properties
-│ -19 files, 23088 bytes uncompressed, 8842 bytes compressed: 61.7%
-│ +19 files, 23072 bytes uncompressed, 8823 bytes compressed: 61.8%
-├── META-INF/MANIFEST.MF
-│ @@ -1,10 +1,10 @@
-│ Manifest-Version: 1.0
-│ +Implementation-Vendor: The Apache Software Foundation
-│ Implementation-Title: Doxia :: Logging API
-│ Implementation-Version: 1.9.1
-│ +Build-Jdk-Spec: 1.7
-│ Specification-Vendor: The Apache Software Foundation
-│ -Specification-Title: Doxia :: Logging API
-│ -Build-Jdk-Spec: 1.8
-│ Created-By: Maven Jar Plugin 3.2.0
-│ +Specification-Title: Doxia :: Logging API
-│ Specification-Version: 1.9
-│ -Implementation-Vendor: The Apache Software Foundation
-├── org/apache/maven/doxia/logging/PlexusLoggerWrapper.class
-...
-+----------
-
- []
-
- In this example, reference build was done with JDK 8 (see <<<│ -Build-Jdk-Spec: 1.8>>>), but the current build was done with JDK 7 (see <<<│ +Build-Jdk-Spec: 1.7>>>): this explains both
- difference in content of <<<META-INF/MANIFEST.MF>>> of every .jar file, but also of some bytecode in <<<.class>>> files.
-
- When general environment issues have been fixed, for each remaining issue, you'll have to find which Maven plugin generated the content and see if there is an update of the plugin
- that generates reproducible output: see the plugins table of the {{{Configuring for Reproducible Builds guide}/guides/mini/guide-reproducible-builds.html}} for an initial list.
+When general environment issues have been fixed, for each remaining issue, you'll have to find which Maven plugin generated the content and see if there is an update of the plugin that generates reproducible output: see the plugins table of the [/guides/mini/guide-reproducible-builds.html](#Configuring_for_Reproducible_Builds_guide) for an initial list.
diff --git a/src/site/markdown/usage.md.vm b/src/site/markdown/usage.md.vm
index b138862..cffbfdb 100644
--- a/src/site/markdown/usage.md.vm
+++ b/src/site/markdown/usage.md.vm
@@ -1,38 +1,30 @@
- ------
- Usage
- ------
- Hervé Boutemy
- ------
- 2020-06-20
- ------
+<!--
+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
-~~ 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.
+http://www.apache.org/licenses/LICENSE-2.0
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+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.
+-->
-Usage
+# Usage
-* Recording <<<.buildinfo>>> File
+Recording `.buildinfo` File
+---------------------------
- Recording build result into a <<<.buildinfo>>> file is typically done on command line by calling <<<artifact:buildinfo>>> goal after the normal build:
+Recording build result into a `.buildinfo` file is typically done on command line by calling `artifact:buildinfo` goal after the normal build:
--------
+```
$ mvn clean verify artifact:buildinfo
[INFO] Scanning for projects...
[INFO]
@@ -45,17 +37,18 @@ $ mvn clean verify artifact:buildinfo
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
--------
+```
- This records data on the current build results into a <<<.buildinfo>>> file using {{{https://reproducible-builds.org/docs/jvm/}Reproducible Builds <<<.buildinfo>>> for the JVM}} format.
+This records data on the current build results into a `.buildinfo` file using [Reproducible Builds `.buildinfo` for the JVM](https://reproducible-builds.org/docs/jvm/) format.
- Notice that if the build is multi-module, only 1 <<<.buildinfo>>> file is generated, in the last module of the reactor, that will record aggregated results for all the modules.
+Notice that if the build is multi-module, only 1 `.buildinfo` file is generated, in the last module of the reactor, that will record aggregated results for all the modules.
-* Checking Reproducible Build: Comparing Current Build Against Previous One
+Checking Reproducible Build: Comparing Current Build Against Previous One
+-------------------------------------------------------------------------
- <<<artifact:compare>>> goal compares reference artifacts against current build output to display <<Reproducible Build output summary>>:
+`artifact:compare` goal compares reference artifacts against current build output to display **Reproducible Build output summary**:
--------
+```
$ mvn -Papache-release clean verify -Dgpg.skip artifact:compare
[INFO] Scanning for projects...
...
@@ -76,4 +69,4 @@ Downloading from central: https://repo.maven.apache.org/maven2/org/apache/maven/
[WARNING] see also https://maven.apache.org/guides/mini/guide-reproducible-builds.html
[INFO] Reproducible Build output comparison saved to /tmp/doxia-1.9.1/doxia-modules/doxia-module-markdown/target/doxia-module-markdown-1.9.1.buildcompare
[INFO] Aggregate buildcompare copied to /tmp/doxia-1.9.1/target/doxia-1.9.1.buildcompare
--------
+```