From: Manoj Srivastava <srivasta@debian.org>
Date: Sat, 21 Nov 2009 06:03:12 +0000 (-0600)
Subject: Clarify rule for debian/rules shebang line
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=16afbcbe97a96431bb2257e2f6c49bd43bad1914;p=debian%2Fdebian-policy.git

Clarify rule for debian/rules shebang line

Explicitly state that  "make -f debian/rules" and "./debian/rules"
must behave  identically, to prevent confusion, and to promote
reproducibility, and conform to the principle of least surprise.

Signed-off-by: Ben Finney <ben+debian@benfinney.id.au>
Signed-off-by: Kurt Roeckx <kurt@roeckx.be>
Signed-off-by: Russ Allbery <rra@debian.org>
Signed-off-by: Manoj Srivastava <srivasta@debian.org>
---

diff --git a/policy.sgml b/policy.sgml
index b8b97f4..042e82f 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -1725,7 +1725,10 @@
 	<p>
 	  It must start with the line <tt>#!/usr/bin/make -f</tt>,
 	  so that it can be invoked by saying its name rather than
-	  invoking <prgn>make</prgn> explicitly.
+	  invoking <prgn>make</prgn> explicitly. That is, invoking
+          either of <tt>make -f debian/rules <em>args...</em></tt>
+          or <tt>./debian/rules <em>args...</em></tt> must result in
+          identical behavior.
 	</p>
 
 	<p>