From 16bb4f404fe0c9816719adce36b15daaac5dc451 Mon Sep 17 00:00:00 2001 From: Ian Jackson Date: Sat, 10 Feb 2018 15:27:19 +0000 Subject: git-debrebase: explain why breakwater bases must be merges Signed-off-by: Ian Jackson --- NOTES.git-debrebase | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/NOTES.git-debrebase b/NOTES.git-debrebase index 635f72b..95ad453 100644 --- a/NOTES.git-debrebase +++ b/NOTES.git-debrebase @@ -47,6 +47,18 @@ overall format m{^\[git-debrebase (?:\w*-)?upstream combine \.((?: $extra_orig_namepart_re)+)\]} +Every breakwater commit must be a merge. In principle, this is not +necessary. After all, we are relying on the + [git-debrebase breakwater: ...] +commit message annotation in "declare" breakwater merges (which +do not have any upstream changes), to distinguish those breakwater +merges from ordinary pseudomerges (which we might just try to strip). + +However, the user is going to be doing git-rebase a lot. We really +don't want them to rewrite a breakwater base commit. git-rebase +trips up on merges, so that is a useful safety catch. + + ========= workflow -- cgit v1.2.3