[Reproducible-commits] [source-date-epoch-spec] 01/01: more instructive wording, and add some considerations for descriptive text and timezones

[Ximin Luo]

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

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

commit 6fbb8c41e5cd7dda74c082e08514644cc3dd4671
Author: Ximin Luo <infinity0 at debian.org>
Date:   Thu Aug 27 17:23:55 2015 +0200

    more instructive wording, and add some considerations for descriptive text and timezones
---
 source-date-epoch-spec.xml | 25 +++++++++++++++----------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/source-date-epoch-spec.xml b/source-date-epoch-spec.xml
index bb41737..aece84c 100644
--- a/source-date-epoch-spec.xml
+++ b/source-date-epoch-spec.xml
@@ -214,9 +214,14 @@
 			<filename>debian/changelog</filename>.
 		</para>
 		<para>
-			Upstream build processes are encouraged to read and use
-			this variable for any embedded timestamps, in place of
-			the "current" date and time of when the process is run.
+			To adhere to this specification, upstream build processes
+			MUST read and use this variable for embedded timestamps,
+			<emphasis>in place of</emphasis> the "current" date and
+			time of when the process is being run. Upstream MAY also
+			patch any relevant descriptive text so that it refers to
+			the source code's modification time instead of the build
+			time, but this is not necessary for the purposes of this
+			specification.
 		</para>
 		<para>
 			Upstream build processes MAY attempt to set this variable
@@ -229,13 +234,13 @@
 		</para>
 		<warning>
 			<para>
-				In addition, care should be taken to avoid
-				timezone and locale-specific formatting of the
-				value of <envar>SOURCE_DATE_EPOCH</envar>. If
-				it is deemed essential that an end-user can
-				see this timestamp in their own locale or
-				timezone, this formatting MUST be delayed until
-				run-time.
+				In addition, care should be taken to avoid timezone
+				and locale-specific formatting of the value of
+				<envar>SOURCE_DATE_EPOCH</envar>. Any embedded
+				timezone MUST be constant at build time and SHOULD
+				refer to UTC. If is deemed essential that an end user
+				read this value in their own locale or timezone, this
+				formatting MUST be delayed until run time.
 			</para>
 		</warning>
 		<para>

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