[source-date-epoch-spec] 02/02: Add an example for timestamp clamping

[Ximin Luo]

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

infinity0 pushed a commit to branch pu/1.1
in repository source-date-epoch-spec.

commit 8ecf58f1508da7d88849bea83edb7d3a7f05c92b
Author: Ximin Luo <infinity0 at debian.org>
Date:   Thu Oct 19 12:12:48 2017 +0200

    Add an example for timestamp clamping
---
 source-date-epoch-spec.xml | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/source-date-epoch-spec.xml b/source-date-epoch-spec.xml
index cd881bc..bdf2e79 100644
--- a/source-date-epoch-spec.xml
+++ b/source-date-epoch-spec.xml
@@ -178,10 +178,25 @@
 
 <sect1>
 	<title>Examples</title>
-	<para>
-		Examples are available at <ulink
-		url="https://wiki.debian.org/ReproducibleBuilds/TimestampsProposal#Examples">https://wiki.debian.org/ReproducibleBuilds/TimestampsProposal#Examples</ulink>.
-	</para>
+	<sect2>
+		<title>Timestamp clamping</title>
+		<para>
+			One can reasonably assume that all source timestamps are
+			before <envar>SOURCE_DATE_EPOCH</envar> and all builds take
+			place after it. This means we can efficiently both preserve
+			source-based timestamps and omit build-specific timestamps,
+			by rewriting timestamps more recent than <envar>SOURCE_DATE_EPOCH</envar>
+			back to the latter. See for example the <option>--clamp-mtime</option>
+			option to GNU tar.
+		</para>
+	</sect2>
+	<sect2>
+		<title>Other examples</title>
+		<para>
+			Other examples are available at <ulink
+			url="https://wiki.debian.org/ReproducibleBuilds/TimestampsProposal#Examples">https://wiki.debian.org/ReproducibleBuilds/TimestampsProposal#Examples</ulink>.
+		</para>
+	</sect2>
 </sect1>
 
 <sect1>

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