From ce1437bfd7ecba8e7364234b3d3bd82fae6d4733 Mon Sep 17 00:00:00 2001
From: Michael Osipov <michaelo@apache.org>
Date: Fri, 18 Oct 2024 14:28:27 +0200
Subject: [PATCH] [MSHARED-1446] Add docs about repro build output timestamp
 boundaries

This closes #73
---
 src/main/java/org/apache/maven/archiver/MavenArchiver.java | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/apache/maven/archiver/MavenArchiver.java b/src/main/java/org/apache/maven/archiver/MavenArchiver.java
index 6a6e446..a6025c0 100644
--- a/src/main/java/org/apache/maven/archiver/MavenArchiver.java
+++ b/src/main/java/org/apache/maven/archiver/MavenArchiver.java
@@ -685,7 +685,9 @@ public void setBuildJdkSpecDefaultEntry(boolean buildJdkSpecDefaultEntry) {
      *         contains only 1 character (not a number)
      * @since 3.6.0
      * @throws IllegalArgumentException if the outputTimestamp is neither ISO 8601 nor an integer, or it's not within
-     *             the valid range 1980-01-01T00:00:02Z to 2099-12-31T23:59:59Z
+     *             the valid range 1980-01-01T00:00:02Z to 2099-12-31T23:59:59Z as defined by
+     *             <a href="https://pkwaredownloads.blob.core.windows.net/pem/APPNOTE.txt">ZIP application note</a>,
+     *             section 4.4.6.
      */
     public static Optional<Instant> parseBuildOutputTimestamp(String outputTimestamp) {
         // Fail-fast on nulls