X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=dgit-nmu-simple.7.pod;h=0d2525fc0bce39de870f2c8d3b5e577980f52e61;hp=057f1c8511c16e2ce46242d287c5905090c0a875;hb=3991eff63504d351b858d3a84392dbb03245946c;hpb=257cbdd6d28d62dc41650774054d2e2dd923c91a diff --git a/dgit-nmu-simple.7.pod b/dgit-nmu-simple.7.pod index 057f1c85..0d2525fc 100644 --- a/dgit-nmu-simple.7.pod +++ b/dgit-nmu-simple.7.pod @@ -39,14 +39,14 @@ consult the appropriate C workflow tutorial, % dgit clone glibc jessie % cd glibc % git am ~/glibc-security-fix.diff - % dch --nmu Apply upstream's fix for foo bug. + % dch --nmu "Apply upstream's fix for foo bug." % git add debian/changelog && git commit -m"NMU changelog entry" % dpkg-buildpackage -uc -b [ run your tests ] % dch -r && git add debian/changelog && git commit -m"Finalise NMU" % dgit -wgf sbuild -A -c jessie [ final tests on generated .debs ] - % dgit -wgf push jessie + % dgit -wgf [--delayed=5] push jessie [ enter your gnupg passphrase as prompted ] [ see that push and upload are successful ] [ prepare and email NMU diff (git-diff, git-format-patch) ] @@ -56,10 +56,10 @@ consult the appropriate C workflow tutorial, =head1 WHAT KIND OF CHANGES AND COMMITS TO MAKE When preparing an NMU, the git commits you make on the dgit branch -should be simple linear series of commmits with good commit messages. +should be simple linear series of commits with good commit messages. The commit messages will be published in various ways, including perhaps being used as the cover messages for -genrated quilt patches. +generated quilt patches. Do not make merge commits. Do not try to rebase to drop patches - if you need to revert a @@ -104,6 +104,36 @@ tree. It also means you don't care about the package clean target, which is just as well because many package clean targets are broken. +=head1 OTHER GIT BRANCHES + +The dgit git history +(visible in gitk and git log) +is not necessarily related to the maintainer's +or upstream's git history (if any). + +If the maintainer has advertised a git repo with +Vcs-Git +dgit will set up a remote for it, +so you can do + +=over 4 + + % git fetch vcs-git + +=back + +You can cherry pick changes from there, for example. +Note that the maintainer's git history may not be +suitable for use with dgit. +For example, it might be a patches-unapplied branch +or even contain only a debian/ directory. + +=head1 UPLOADING TO DELAYED + +You can use dgit's I<--delayed> option +to upload to the DELAYED queue. +However, you should read the warning about this option in dgit(1). + =head1 SEE ALSO dgit(1), dgit(7), dgit-maint-*(7)