From 233d2b5eea7060eebff598c9edfa5ae659cb7a77 Mon Sep 17 00:00:00 2001 From: Sean Whitton Date: Tue, 3 Apr 2018 11:05:30 -0700 Subject: dgit-maint-debrebase(7): avoiding merges Signed-off-by: Sean Whitton --- dgit-maint-debrebase.7.pod | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/dgit-maint-debrebase.7.pod b/dgit-maint-debrebase.7.pod index 68127b9..0b75d58 100644 --- a/dgit-maint-debrebase.7.pod +++ b/dgit-maint-debrebase.7.pod @@ -55,8 +55,9 @@ This workflow is appropriate for packages where the Debian delta contains multiple pieces which interact, or which you don't expect to be able to upstream soon. For packages with simple and/or short-lived Debian deltas, use of git-debrebase(1) might introduce unneeded -complexity (for examples, see "BEHAVIOUR TO AVOID" below). For such -packages, consider the workflow described in dgit-maint-merge(7). +complexity -- in particular, you cannot use B to +incorporate changes from other contributors. For such packages, +consider the workflow described in dgit-maint-merge(7). =head1 INITIAL DEBIANISATION @@ -270,6 +271,25 @@ I<--deliberately-not-fast-forward> instead of I<--overwrite>. This avoids introducing a new origin commit into 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 GIT CONFIGURATION + +This workflow does not support using B to merge divergent +branches of development (see "OTHER MERGES" in git-debrebase(5)). You +should configure git such that B does not try to merge: + +=over 4 + + % git config --local pull.rebase true + +=back + +Now when you pull work from other Debian contributors, git will rebase +your work on top of theirs. + +If you use this repository for upstream development in addition to +Debian packaging work, you may not want to set this global setting. +Instead, see the B and +BnameE.rebase> settings in git-config(5). =head1 IMPORTING NEW UPSTREAM RELEASES -- cgit v1.2.3