[maven-site] 02/02: buildinfo goal is not necessary for initial build

[hb...@apache.org]

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

commit e14bcf2355f1b29779fe0621289a223e009d777b
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Sat Jul 11 23:30:27 2020 +0200

    buildinfo goal is not necessary for initial build
---
 content/apt/guides/mini/guide-reproducible-builds.apt | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/content/apt/guides/mini/guide-reproducible-builds.apt b/content/apt/guides/mini/guide-reproducible-builds.apt
index 00ff0a4..cce302f 100644
--- a/content/apt/guides/mini/guide-reproducible-builds.apt
+++ b/content/apt/guides/mini/guide-reproducible-builds.apt
@@ -54,14 +54,16 @@ Configuring for Reproducible Builds
 * How to test and fix my Maven build reproducibility?
 
  Using {{{https://github.com/apache/maven-artifact-plugin}<<<maven-artifact-plugin>>>'s <<<buildinfo>>> goal}},
- you can check that two builds produce the same output:
+ you can check that the second build of your project produce the same output than an initial build:
 
- [[1]] build and install: <<<mvn clean install -e -DskipTests artifact:buildinfo>>>
+ [[1]] build and install your project: <<<mvn clean install -e -DskipTests>>> (don't hesitate to customize arguments to better match your project)
 
- [[2]] rebuild and check against the previous install: <<<mvn clean verify -e -DskipTests artifact:buildinfo -Dreference.repo=central>>>
+ [[2]] rebuild (without installing) and check against the previous install: <<<mvn clean verify -e -DskipTests artifact:buildinfo -Dreference.repo=central>>>
 
  []
 
+ The <<<buildinfo>>> goal in the second run will calculate fingerprints for the second build output and for the initial installed output, then compare the 2 build informations and display result.
+
  If something is still not reproducible:
  
  [[1]] Use {{{https://diffoscope.org/}diffoscope}} to find the unstable output. The <<<artifact:buildinfo>>> goal proposes a command with path to files: just copy/paste to launch.