From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Sat, 13 Oct 2018 11:48:12 +0000 (+0100)
Subject: dgit(1): Document that rules clean sometimes not run
X-Git-Tag: archive/debian/8.0~19
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=commitdiff_plain;h=601645922a2dd91735da980227c7bf4198c2071b;ds=sidebyside

dgit(1): Document that rules clean sometimes not run

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
---

diff --git a/dgit.1 b/dgit.1
index 4521cd30..1ee02301 100644
--- a/dgit.1
+++ b/dgit.1
@@ -591,6 +591,13 @@ the build-dependencies are not checked
 .BR -d
 to dpkg-buildpackage),
 which violates policy, but may work in practice.
+
+The rules clean target will only be run if it is needed:
+when dgit is going to build source or binary packages
+from your working tree,
+rather than from your git branch
+(for example because of --include-dirty
+or because the binary package build uses your working tree).
 .TP
 .BR -N " | " --new
 The package is or may be new in this suite.  Without this, dgit will