dgit: Provide --clean=dpkg-source[-d],all-check aka -wda / -wdda

[dgit.git] / dgit.1

diff --git a/dgit.1 b/dgit.1
index 1ee02301ffa02ffe18e22975dd0102599a9f73ec..5155dc04f798bf694d733059940611e9d0148e73 100644 (file)
--- a/dgit.1
+++ b/dgit.1
@@ -598,6 +598,25 @@ 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).
+
+In all cases,
+dgit will check that there are (after rules clean, if applicable) no
+untracked un-ignored files,
+in case these are files you forgot to git add.
+(Except that this check is not done
+for a `3.0 (quilt)' package
+when dgit has to apply patches, dirtily, to the working tree.)
+If your package does not have a good .gitignore
+you will probably need --clean=dpkg-source,no-check aka -wdn.
+.TP
+.BR --clean=dpkg-source "[" -d "]" ,no-check " | " -wdn " | " -wddn
+Like --clean=dpkg-source, but
+does not care about untracked un-ignored files.
+.TP
+.BR --clean=dpkg-source "[" -d "]" ,all-check " | " -wda " | " -wdda
+Like --clean=dpkg-source, but
+fails even on ignored untracked files.
+This could perhaps be used to detect bugs in your rules clean target.
 .TP
 .BR -N " | " --new
 The package is or may be new in this suite.  Without this, dgit will