From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Sun, 6 Jan 2019 12:15:53 +0000 (+0000)
Subject: dgit: Document new --clean=git behaviours
X-Git-Tag: archive/debian/8.3~20
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=commitdiff_plain;h=02034520dc1174e9c841f0a37e9590ce421af06f

dgit: Document new --clean=git behaviours

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

diff --git a/dgit.1 b/dgit.1
index 60bf0d37..6f895744 100644
--- a/dgit.1
+++ b/dgit.1
@@ -542,7 +542,9 @@ to avoid needing the build-dependencies.
 dgit will only actually clean the tree if it needs to
 (because it needs to build the source package
 or binaries from your working tree).
-Otherwise any untracked files will be simply ignored.
+Otherwise
+it will just check that there are no untracked unignored files.
+See --clean=git[-ff],always, below.
 .TP
 .BR --clean=git-ff " | " -wgf
 Use
@@ -553,6 +555,10 @@ git clean -xdf
 but it also removes any subdirectories containing different git
 trees (which only unusual packages are likely to create).
 .TP
+.BR --clean=git "[" -ff "]" ,always " | " -wga " | " -wgfa
+Like --clean=git, but always does the clean and not just a check,
+deleting any untracked un-ignored files.
+.TP
 .BR --clean=check " | " --clean=check,ignores " | " -wc " | " -wci
 Merely check that the tree is clean (does not contain uncommitted
 files).