[Reproducible-commits] [source-date-epoch-spec] 01/05: Start specifying SOURCE_DATE_EPOCH itself.

[Chris Lamb]

This is an automated email from the git hooks/post-receive script.

lamby pushed a commit to branch master
in repository source-date-epoch-spec.

commit b580f2194327fba9563a8d57223b7019e0b1ff1d
Author: Chris Lamb <lamby at debian.org>
Date:   Sat Aug 22 13:55:23 2015 +0200

    Start specifying SOURCE_DATE_EPOCH itself.
---
 source-date-epoch-spec.xml | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/source-date-epoch-spec.xml b/source-date-epoch-spec.xml
index f2d1c9f..f4e7c72 100644
--- a/source-date-epoch-spec.xml
+++ b/source-date-epoch-spec.xml
@@ -37,8 +37,38 @@
 
 <sect1>
 	<title>Proposal</title>
+	<para>
+		We propose the following build-time environment variable to be
+		consumed by build systems in place of using the "current" time
+		and date
+	</para>
+	<para>
+		It is intended to be a universal standard and not specific to
+		any particular project or distribution.
+	</para>
 	<sect2>
 		<title>SOURCE_DATE_EPOCH</title>
+		<para>
+			A UNIX timestamp which is defined as the number of
+			seconds (excluding leap seconds) since 01 Jan 1970
+			00:00 UTC. This is independent of timezones, i.e. there
+			is no way to specify this "in another timezone".
+		</para>
+		<para>
+			The value is an integer with no fractional component,
+			similar to that output by "date +%s".
+		</para>
+		<para>
+			Upstream build processes are encouraged to read this
+			variable for any embedded timestamps.
+		</para>
+		<para>
+			The actual values should be set to the time of the last
+			modification time of the source. In Debian, this is
+			automatically set to the same time as the latest entry
+			in debian/changelog, i.e. the same as the output of
+			dpkg-parsechangelog --show-field=Date.
+		</para>
 	</sect2>
 
 	<sect2>

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/source-date-epoch-spec.git