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>

Reply via email to