Make readonly vs push configurable

[dgit.git] / dgit.1

diff --git a/dgit.1 b/dgit.1
index c569347e658bb6480e12072b0985c5dcef4670e1..dd083ac5eb2e84a70f5c775f30c887aff6d58ef4 100644 (file)
--- a/dgit.1
+++ b/dgit.1
@@ -267,7 +267,7 @@ 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
 
 --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.
+git add.  --clean=git can also avoid needing the build-dependencies.

 .TP
 .BR --clean=git-ff " | " -wgf
 The source tree should be cleaned, before building a source package
 .TP
 .BR --clean=git-ff " | " -wgf
 The source tree should be cleaned, before building a source package


@@ -278,6 +278,10 @@ This is like
 but it also removes any subdirectories containing different git
 trees (which only unusual packages are likely to create).
 .TP
 but it also removes any subdirectories containing different git
 trees (which only unusual packages are likely to create).
 .TP

+.BR --clean=check " | " -wn
+Merely check that the tree is clean (does not contain uncommitted
+files), before building a source package.
+.TP

 .BR --clean=none " | " -wn
 Do not clean the tree before building a source package.  If there are
 files which are not in git, or if the build creates such files, a
 .BR --clean=none " | " -wn
 Do not clean the tree before building a source package.  If there are
 files which are not in git, or if the build creates such files, a


@@ -288,6 +292,15 @@ Use dpkg-buildpackage to do the clean, so that the source package
 is cleaned by dpkg-source running the package's clean target.
 This is the default.  It requires the package's build dependencies.
 .TP
 is cleaned by dpkg-source running the package's clean target.
 This is the default.  It requires the package's build dependencies.
 .TP

+.BR --clean=dpkg-source-d " | " -wdd
+Use
+.B dpkg-buildpackage -d
+to do the clean, so that the source package
+is cleaned by dpkg-source running the package's clean target.
+The build-dependencies are not checked (due to
+.BR -d ),
+which violates policy, but may work in practice.
+.TP

 .BR -N " | " --new
 The package may be new in this suite.  Without this, dgit will
 refuse to push.
 .BR -N " | " --new
 The package may be new in this suite.  Without this, dgit will
 refuse to push.


@@ -584,6 +597,14 @@ on the dgit command line.
 .TP
 .BI dgit.default.distro
 .TP
 .TP
 .BI dgit.default.distro
 .TP

+.BR dgit-distro. \fIdistro\fR .readonly " " auto | true | false
+.TP
+.BR dgit-distro. \fIdistro\fR /push. *
+If set, overrides corresponding non \fB/push\fR config when
+.BR readonly=false ,
+or when pushing and
+.BR readonly=auto .
+.TP

 .BI dgit-distro. distro .username
 .TP
 .BI dgit-distro. distro .git-url
 .BI dgit-distro. distro .username
 .TP
 .BI dgit-distro. distro .git-url