From 6bc903d5c9cfd89fa8d05c1f895fa2d3a59d4f1b Mon Sep 17 00:00:00 2001
From: Pat Maddox <pat@patmaddox.com>
Date: Fri, 13 Dec 2024 18:43:58 -0800
Subject: [PATCH] release: Document reproducible release tarballs

PR: 283214

Signed-off-by: Pat Maddox <pat@patmaddox.com>
---
 share/man/man7/release.7 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/share/man/man7/release.7 b/share/man/man7/release.7
index 5c5c11efd0fbb9..0f4cd6897b112e 100644
--- a/share/man/man7/release.7
+++ b/share/man/man7/release.7
@@ -283,6 +283,16 @@ This is intended for use only when
 .Fa /usr/ports
 is expected to exist by alternative means.
 .El
+.Sh REPRODUCIBLE BUILDS
+Different builders can produce bit-identical release tarballs using
+.Va PKG_TIMESTAMP
+and
+.Va REVISION :
+.Bd -literal -offset indent
+git checkout <REVISION>
+make -DWITH_REPRODUCIBLE_BUILD buildworld buildkernel
+make -C release -DWITH_REPRODUCIBLE_BUILD PKG_TIMESTAMP=<TIMESTAMP> packagesystem
+.Ed
 .Sh EMBEDDED BUILDS
 The following
 .Fa release.conf