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
The following commit(s) were added to refs/heads/master by this push:
new f65da1a Link to the reproducible builds guide on maven.apache.org
f65da1a is described below
commit f65da1a9e838865f8ee46a0bae0e1bc5f1b649c4
Author: Sylwester Lachiewicz <[email protected]>
AuthorDate: Sat Oct 31 19:58:15 2026 +0000
Link to the reproducible builds guide on maven.apache.org
---
src/site/markdown/index.md | 2 +-
src/site/markdown/reproducible.md.vm | 117 -----------------------------------
src/site/site.xml | 4 --
3 files changed, 1 insertion(+), 122 deletions(-)
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index 695680d..c0d7e21 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -48,4 +48,4 @@ If you feel like the plugin is missing a feature or has a
defect, you can fill a
To provide you with better understanding on some usages of the Artifact
Plugin, you can take a look into the following examples:
-- [How to diagnose issues with Reproducible Builds?](./reproducible.html)
+- [How to diagnose issues with Reproducible
Builds?](https://maven.apache.org/guides/mini/guide-reproducible-builds.html#Reading_the_artifact.3Acompare_output)
diff --git a/src/site/markdown/reproducible.md.vm
b/src/site/markdown/reproducible.md.vm
deleted file mode 100644
index aa71e7b..0000000
--- a/src/site/markdown/reproducible.md.vm
+++ /dev/null
@@ -1,117 +0,0 @@
----
-title: Diagnosing Reproducible Build Issue
-author:
- - Hervé Boutemy
-date: 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
-
-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.
--->
-
-# Diagnosing Reproducible Build Issues
-
-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...
-...
-[INFO] --- maven-artifact-plugin:${project.version}:buildinfo (default-cli) @
doxia-module-markdown ---
-[INFO] Saved aggregate info on build to
/tmp/doxia-1.9.1/doxia-modules/doxia-module-markdown/target/doxia-module-markdown-1.9.1.buildinfo
-[INFO] Checking against reference build from central...
-Downloading from central:
https://repo.maven.apache.org/maven2/org/apache/maven/doxia/doxia-module-markdown/1.9.1/doxia-module-markdown-1.9.1.buildinfo
-[WARNING] Reference buildinfo file not found: it will be generated from
downloaded reference artifacts
-[INFO] Reference build java.version: 1.8 (from MANIFEST.MF Build-Jdk-Spec)
-[INFO] Reference build java.version: 1.8 (from MANIFEST.MF Build-Jdk-Spec)
-[ERROR] Current build java.version: 1.7 (from MANIFEST.MF Build-Jdk-Spec)
-[INFO] Reference build os.name: Unix (from pom.properties newline)
-[INFO] Minimal buildinfo generated from downloaded artifacts:
/tmp/doxia-1.9.1/target/reference/doxia-module-markdown-1.9.1.buildinfo
-[WARNING] size mismatch doxia-logging-api-1.9.1.jar: investigate with
diffoscope target/reference/doxia-logging-api-1.9.1.jar
doxia-logging-api/target/doxia-logging-api-1.9.1.jar
-...
-[WARNING] size mismatch doxia-module-markdown-1.9.1.jar: investigate with
diffoscope target/reference/doxia-module-markdown-1.9.1.jar
doxia-modules/doxia-module-markdown/target/doxia-module-markdown-1.9.1.jar
-[WARNING] Reproducible Build output summary: 39 files ok, 18 different
-[WARNING] see diff target/reference/doxia-module-markdown-1.9.1.buildinfo
doxia-modules/doxia-module-markdown/target/doxia-module-markdown-1.9.1.buildinfo
-[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
-...
-```
-
-Multiple interesting parts are available:
-
-- 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:
-
- ```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
- ...
- ```
-
-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
[/guides/mini/guide-reproducible-builds.html](#Configuring_for_Reproducible_Builds_guide)
for an initial list.
diff --git a/src/site/site.xml b/src/site/site.xml
index 6ca8d2f..2565471 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -39,9 +39,5 @@ under the License.
<item name="License" href="http://www.apache.org/licenses/"/>
<item name="Download" href="download.html"/>
</menu>
-
- <menu name="Examples">
- <item name="Diagnosing Reproducible Build Issues"
href="reproducible.html"/>
- </menu>
</body>
</site>