X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=dgit.1;h=712f36dc80855d8b4e948f180fe4b85680eadbb8;hp=7e74d5b77f62fdfc2ad5782c3973e8b9b4907c62;hb=282db732c877da890e55e5664e43636f8a9647ad;hpb=a78bf8c39cf81580dab3cfed267203c1ec53952e diff --git a/dgit.1 b/dgit.1 index 7e74d5b7..712f36dc 100644 --- a/dgit.1 +++ b/dgit.1 @@ -167,6 +167,9 @@ build-host and build\-dir can be passed as separate arguments; this is assumed to be the case if the first argument contains no : (except perhaps on in [ ], to support IPv6 address literals). + +You will need similar enough versions of dgit on the build-host and +the invocation host. .TP .B dgit quilt-fixup Looks to see if the tree is one which dpkg-source cannot properly @@ -217,7 +220,7 @@ 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. .TP .BR --clean=dpkg-source | -wd -Use dpkg-buildpackage to do the build, so that the source package +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 @@ -359,6 +362,20 @@ Specifies the .changes file which is to be uploaded. By default dgit push looks for single .changes file in the parent directory whose filename suggests it is for the right package and version - or, if there is a _multi.changes file, dgit uses that. + +If the specified +.I changesfile +pathname contains slashes, the directory part is also used as +the value for +.BR --build-products-dir ; +otherwise, the changes file is expected in that directory (by +default, in +.BR .. ). +.TP +.BI --build-products-dir= directory +Specifies where to find the built files to be uploaded. +By default, dgit looks in the parent directory +.BR .. ). .TP .BI --existing-package= package dgit push needs to canonicalise the suite name. Sometimes, dgit @@ -381,6 +398,9 @@ instead. Furthermore, the specified directory will be emptied, removed and recreated before dgit starts, rather than removed after dgit finishes. The directory specified must be an absolute pathname. +.TP +.BI --no-rm-on-error +Do not delete the destination directory if clone fails. .SH WORKFLOW - SIMPLE It is always possible with dgit to clone or fetch a package, make changes in git (using git-commit) on the suite branch