[Reproducible-commits] [source-date-epoch-spec] 02/04: make proposal definition a bit more precise

[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 e704a1dc5530a434c69a48e11bbc8e0268257bbd
Author: Ximin Luo <infinity0 at debian.org>
Date:   Thu Aug 27 16:42:29 2015 +0200

    make proposal definition a bit more precise
---
 source-date-epoch-spec.xml | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/source-date-epoch-spec.xml b/source-date-epoch-spec.xml
index b00aeb9..39da80a 100644
--- a/source-date-epoch-spec.xml
+++ b/source-date-epoch-spec.xml
@@ -186,9 +186,8 @@
 <sect1>
 	<title>Proposal</title>
 	<para>
-		We propose the following environment variable to be consumed by
-		build systems, tools and wrappers and for it to be used in
-		place of the "current" date and time.
+		We propose the following environment variables to be consumed by
+		build systems, tools and wrappers.
 	</para>
 	<para>
 		It is intended to be a universal standard and not specific to
@@ -197,15 +196,15 @@
 	<sect2>
 		<title><envar>SOURCE_DATE_EPOCH</envar></title>
 		<para>
-			A UNIX timestamp defined as the number of seconds
+			A UNIX timestamp, defined as the number of seconds
 			(excluding leap seconds) since <computeroutput>01 Jan
-			1970 00:00 UTC</computeroutput> exposed through the
+			1970 00:00:00 UTC</computeroutput> exposed through the
 			system's usual environment mechanism.
 		</para>
 		<para>
-			The value is an ASCII representation of integer with no
-			fractional component, similar to the output of
-			<command>date +%s</command>.
+			The value is an ASCII representation of an integer with
+			no fractional component, similar to the output of
+			<command>date +%s</command> in GNU coreutils.
 		</para>
 		<para>
 			The value should be set to the time of the last
@@ -216,7 +215,8 @@
 		</para>
 		<para>
 			Upstream build processes are encouraged to read and use
-			this variable in place of any embedded timestamps.
+			this variable for any embedded timestamps, in place of
+			the "current" date and time of when the process is run.
 		</para>
 
 		<warning>
@@ -233,7 +233,7 @@
 				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
+				timezone, this formatting MUST be delayed until
 				run-time.
 			</para>
 		</warning>

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