X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=NOTES.git-debrebase;h=ca78c9386414aeff95a719b7ca2d37642051194b;hb=9157ed980b82c0664685e1cf8941c360fb2b11e1;hp=d2b88b6f19b9c4509d411a485bc038a628319e7d;hpb=4f22209a590da904276c3a52643473f44cc22d18;p=dgit.git diff --git a/NOTES.git-debrebase b/NOTES.git-debrebase index d2b88b6f..ca78c938 100644 --- a/NOTES.git-debrebase +++ b/NOTES.git-debrebase @@ -1,4 +1,8 @@ TODO + --anchor option to specify commit(s) to treat as as anchor(s) + + rename "launder" operation to "launder-v0" + reference docs git-debrebase(5) data model git-debrebase(1) command line @@ -44,29 +48,29 @@ overall format [git-debrebase: split mixed commit, debian part] [git-debrebase: split mixed commit, upstream-part] [git-debrebase: convert dgit import, debian changes] -[git-debrebase breakwater: convert dgit import, upstream changes] +[git-debrebase anchor: convert dgit import, upstream changes] [git-debrebase upstream-combine . PIECE[ PIECE...]: new upstream] -[git-debrebase breakwater: new upstream NEW-UPSTREAM-VERSION, merge] +[git-debrebase anchor: new upstream NEW-UPSTREAM-VERSION, merge] [git-debrebase: new upstream NEW-UPSTREAM-VERSION, changelog] [git-debrebase convert-from-gbp: drop patches] -[git-debrebase breakwater: declare upstream] +[git-debrebase anchor: declare upstream] [git-debrebase pseudomerge: stitch] [git-debrebase convert-to-gbp: commit patches] m{^\[git-debrebase (?:\w*-)?upstream combine \.((?: $extra_orig_namepart_re)+)\]} -Every breakwater commit must be a merge. In principle, this is not +Every anchor 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 + [git-debrebase anchor: ...] +commit message annotation in "declare" anchor merges (which +do not have any upstream changes), to distinguish those anchor 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 +don't want them to rewrite an anchor commit. git-rebase trips up on merges, so that is a useful safety catch. @@ -267,7 +271,7 @@ import from gbp new breakwater is old HEAD commit to remove d/patches - breakwater pseudomerge with upstream + anchor merge with upstream "rebase" of pq branch, each commit with d/patches stripped ]