X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=dgit-maint-gbp.7.pod;h=b8abd66cb6dcce1713ddc6dcb9b15114f412339b;hp=60fab5c9e619d84052fe87658ab0316a0138c667;hb=52174c9a5976b18dc3d2ff020a962a84db35019c;hpb=066c9b06dae913c2bba7a7a729445edceafd3fd2 diff --git a/dgit-maint-gbp.7.pod b/dgit-maint-gbp.7.pod index 60fab5c9..b8abd66c 100644 --- a/dgit-maint-gbp.7.pod +++ b/dgit-maint-gbp.7.pod @@ -22,10 +22,6 @@ Provide a better, more detailed git history to downstream dgit users, such as people using dgit to do an NMU (see dgit-nmu-simple(7) and dgit-user(7)). -=item - -Incorporate NMUs with a single command (see below). - =back Note that we assume a patches-unapplied repository: the upstream @@ -35,6 +31,15 @@ normally used with patches-unapplied. =head1 GIT CONFIGURATION +If you have configured an I in your gbp.conf, you should +tell dgit about it: + +=over 4 + + % git config --global dgit.default.build-products-dir /home/spwhitton/build-area + +=back + If you run =over 4 @@ -50,24 +55,24 @@ branch, never the dgit patches-applied branch. =head1 BUILDING -If you use gbp-buildpackage(1) to generate your orig tarballs, you -will need to perform the first build with gbp-buildpackage(1) directly -(this is due to Debian bug #841084). - -Otherwise, you can perform builds like this: +You can perform test builds like this: =over 4 - % dgit [--allow-dirty] gbp-build [OPTIONS] + % dgit [--include-dirty] gbp-build [OPTIONS] =back -where I<--allow-dirty> is needed for testing uncommitted changes, and +where I<--include-dirty> is needed for testing uncommitted changes, and I are any further options to be passed on to gbp-buildpackage(1). -When you are ready to build for upload, you will probably want to use -sbuild(1) or pbuilder(1), or do a source-only upload. Either +If you are doing a source-only upload, you do not need to prepare a +I<_source.changes>, as B will take of that on your +behalf. + +If you need to include binaries with your upload, you will probably +want to use sbuild(1), pbuilder(1) or cowbuilder(1): =over 4 @@ -75,37 +80,33 @@ sbuild(1) or pbuilder(1), or do a source-only upload. Either =back -or +replacing 'sbuild' with 'pbuilder' or 'cowbuilder' if appropriate. -=over 4 +We use I<--rm-old-changes> to ensure that there is exactly one changes +file corresponding to this package, so we can be confident we're +uploading what we intend (though B will do some safety +checks). - % dgit --rm-old-changes gbp-build --git-pbuilder +Note that none of the commands in this section are required to upload +with dgit. You can invoke gbp-buildpackage(1), pbuilder(1), +cowbuilder(1) and sbuild(1) directly. However, the defaults for these +tools may leave you with something that dgit will refuse to upload +because it doesn't match your git HEAD. -=back +As a general rule, leave all signing and tagging to dgit. -or +=head1 UPLOADING + +Don't use I<--git-tag>: B will do this for you. To do a +source-only upload: =over 4 - % dgit --rm-old-changes --gbp build-source + % dgit --gbp push-source =back -We use I<--rm-old-changes> to ensure that there is exactly one changes -file corresponding to this package, so we can be confident we're -uploading what we intend (though B will do some safety -checks). - -Note that all of the commands in this section are not required to -upload with dgit. You can invoke gbp-buildpackage(1), pbuilder(1) and -sbuild(1) directly. However, the defaults for these tools may leave -you with something that dgit will refuse to upload because it doesn't -match your git HEAD. As a general rule, leave all signing and tagging -to dgit. - -=head1 UPLOADING - -Don't use I<--git-tag>: B will do this for you. To upload: +or if you need to include binaries, =over 4 @@ -114,11 +115,18 @@ Don't use I<--git-tag>: B will do this for you. To upload: =back This will push your git history to the dgit-repos, but you probably -want to follow it up with a push to alioth. +want to follow it up with a push to salsa. You will need to pass I<--overwrite> if the previous upload was not performed with dgit. +If this is first ever dgit push of the package, consider passing +I<--deliberately-not-fast-forward> instead of I<--overwrite>. This +avoids introducing a new origin commit into the dgit view of your git +history. (This origin commit would represent the most recent non-dgit +upload of the package, but this should already be represented in your +git history.) + =head1 INCORPORATING NMUS B can't yet incorporate NMUs into patches-unapplied gbp