summaryrefslogtreecommitdiff
path: root/dgit.1
diff options
context:
space:
mode:
authorIan Jackson <ijackson@chiark.greenend.org.uk>2015-06-30 21:25:38 +0100
committerIan Jackson <ijackson@chiark.greenend.org.uk>2015-07-04 19:24:46 +0100
commit54bd461a80ec31613c02831bd7c889ea9f91ed65 (patch)
tree0609a88d334637088f9b463346d886d42b0090a9 /dgit.1
parentf2b31f244345116f1f64d0b56afa76eedaff69c4 (diff)
--clean=git and --clean=none cause dgit to pass -nc to dpkg-buildpackage, suppressing calls to the package's clean target. Also, expand the documentation in this area slightly. Closes:#768590.
Diffstat (limited to 'dgit.1')
-rw-r--r--dgit.113
1 files changed, 11 insertions, 2 deletions
diff --git a/dgit.1 b/dgit.1
index 9705f0a..f183e8e 100644
--- a/dgit.1
+++ b/dgit.1
@@ -248,11 +248,20 @@ Valid with dgit fetch and dgit pull, only.
The source tree should be cleaned, before building a source package
with one of the build options, using
.BR "git clean -xdf" .
-This will delete all files which are not tracked by git.
+This will delete all files which are not tracked by git. Also, -wg
+causes dgit to pass
+.B -nc
+to dpkg-buildpackage, which prevents the package's own clean target
+from being run.
+
+--clean=git is useful when the package's clean target is troublesome;
+the downside is simply that git clean may delete files you forgot to
+git add.
.TP
.BR --clean=none | -wn
Do not clean the tree before building a source package. If there are
-files which are not in git, a subsequent dgit push will fail.
+files which are not in git, or if the build creates such files, a
+subsequent dgit push will fail.
.TP
.BR --clean=dpkg-source | -wd
Use dpkg-buildpackage to do the clean, so that the source package