From 1d01e5ebb230a058093afa0058cde2429545fc54 Mon Sep 17 00:00:00 2001 From: Sean Whitton Date: Tue, 28 Feb 2017 09:45:02 -0700 Subject: [PATCH] dgit-*(7): --deliberately-not-fast-forward for first dgit push Signed-off-by: Sean Whitton --- dgit-maint-gbp.7.pod | 7 +++++++ dgit-maint-merge.7.pod | 7 ++++++- dgit-maint-native.7.pod | 8 ++++++++ dgit-sponsorship.7.pod | 8 ++++++++ 4 files changed, 29 insertions(+), 1 deletion(-) diff --git a/dgit-maint-gbp.7.pod b/dgit-maint-gbp.7.pod index c31dfa59..3c438ab1 100644 --- a/dgit-maint-gbp.7.pod +++ b/dgit-maint-gbp.7.pod @@ -111,6 +111,13 @@ want to follow it up with a push to alioth. 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 diff --git a/dgit-maint-merge.7.pod b/dgit-maint-merge.7.pod index cfbe1c35..22be1c9e 100644 --- a/dgit-maint-merge.7.pod +++ b/dgit-maint-merge.7.pod @@ -241,7 +241,12 @@ To achieve this, you might need to delete I. One way to have dgit check your progress is to run B. -The first dgit push will require I<--overwrite>. +The first dgit push will require I<--overwrite>. If this is the 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 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 SOURCE PACKAGE CONFIGURATION diff --git a/dgit-maint-native.7.pod b/dgit-maint-native.7.pod index 03aee59b..34aaafff 100644 --- a/dgit-maint-native.7.pod +++ b/dgit-maint-native.7.pod @@ -78,6 +78,14 @@ so that your history, which will be pushed to the dgit git server, is fast forward from the dgit archive view. +Alternatively, +if this was the first ever dgit push of the package, +you can avoid this merge commit by +passing C<--deliberately-not-fast-forward>. +instead of C<--overwrite>. +This avoids introducing a new origin commit into +your git history. + =head1 SUBSEQUENT PUSHES =over 4 diff --git a/dgit-sponsorship.7.pod b/dgit-sponsorship.7.pod index 8d5b72da..08083290 100644 --- a/dgit-sponsorship.7.pod +++ b/dgit-sponsorship.7.pod @@ -257,6 +257,14 @@ you may need to pass C<--overwrite> to dgit. +Alternatively, +if this was the first ever dgit push of the package, +you can pass C<--deliberately-not-fast-forward> +instead of C<--overwrite>. +This avoids introducing a new origin commit +into the dgit view of +the sponsee's git history +which is unnecessary and could be confusing. =head1 SPONSORING A NON-GIT-USING SPONSEE -- 2.30.2