summary refs log tree commit diff stats
diff options
context:
space:
mode:
-rw-r--r--doc/intern.rst11
-rw-r--r--doc/packaging.rst4
-rw-r--r--readme.md3
3 files changed, 17 insertions, 1 deletions
diff --git a/doc/intern.rst b/doc/intern.rst
index ab74c4a3a..fe0d333fd 100644
--- a/doc/intern.rst
+++ b/doc/intern.rst
@@ -68,6 +68,17 @@ More information about its options can be found in the `koch <koch.html>`_
 documentation.
 
 
+Reproducible builds
+-------------------
+
+Set the compilation timestamp with the `SOURCE_DATE_EPOCH` environment variable.
+
+.. code:: cmd
+
+  export SOURCE_DATE_EPOCH=$(git log -n 1 --format=%at)
+  koch boot # or `./build_all.sh`
+
+
 Developing the compiler
 =======================
 
diff --git a/doc/packaging.rst b/doc/packaging.rst
index fcdc4ae04..7976dfe92 100644
--- a/doc/packaging.rst
+++ b/doc/packaging.rst
@@ -6,6 +6,9 @@ This page provide hints on distributing Nim using OS packages.
 
 See `distros <distros.html>`_ for tools to detect Linux distribution at runtime.
 
+See `here <intern.html#bootstrapping-the-compiler-reproducible-builds>`_ for how to
+compile reproducible builds.
+
 Supported architectures
 -----------------------
 
@@ -71,3 +74,4 @@ What to install:
 - Optionally: manpages, documentation, shell completion
 - When installing documentation, .idx files are not required
 - The "compiler" directory contains compiler sources and should not be part of the compiler binary package
+
diff --git a/readme.md b/readme.md
index b28c25ec1..7f333d5d4 100644
--- a/readme.md
+++ b/readme.md
@@ -71,7 +71,6 @@ the installation instructions on the website to do so: https://nim-lang.org/inst
 
 For package maintainers: see [packaging guidelines](https://nim-lang.github.io/Nim/packaging.html).
 
-
 First, get Nim from github:
 
 ```
@@ -89,6 +88,8 @@ should add the ``bin`` directory to your PATH.
 
 See also [rebuilding the compiler](doc/intern.rst#rebuilding-the-compiler).
 
+See also [reproducible builds](doc/intern.rst#reproducible-builds).
+
 ## Koch
 
 ``koch`` is the build tool used to build various parts of Nim and to generate