X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=NOTES.git-debrebase;h=c5b2e23bd794d873d6ea6913386267743efd3b7a;hb=8cb940dbc6a36ca9db9c38428a5d5031837e68f4;hp=e0a67b5b3ea470d09614934c131e5fc7c8ddf675;hpb=7c3763c866d9cca28d2f4d2368028d708694e3e9;p=dgit.git

diff --git a/NOTES.git-debrebase b/NOTES.git-debrebase
index e0a67b5b..c5b2e23b 100644
--- a/NOTES.git-debrebase
+++ b/NOTES.git-debrebase
@@ -174,6 +174,65 @@ so that the overall result will be series of pseudomerges.
 
 ========================================
 
+So, pm handling specifics:
+
+strategy is to avoid making needless pseudomerges
+pseudomerges that exist will be preserved
+(by being included in will-overwrite)
+
+This is good because the presence of a pseudomerge means we know we
+want to keep it; and that allows explicit control over history detail
+level.
+
+It does mean we must avoid making the pseudomerges unnecessarily.
+They should be made just before (ideally, part of) dgit push.
+
+1. git-debrebase [-i etc.]
+
+     should:
+        check for will-overwrite
+        if is already a will-overwrite, fine, do no more
+        if not:
+
+        check our origin branch exists and we are ff from it
+        if not fail
+
+        check our other might-be-pushed to branches
+        check we are ff from them
+        if not fail
+
+        set will-overwrite to something which is ff from
+          all above branches
+
+        we use our tip, as discussed above
+        (optionally, can use some other commit which is ff
+         from all of the above, eg one of them)
+
+2. git-debrebase stitch [--noop-ok]
+
+    makes pseudomerge with will-overwrite
+    deletes will-overwrite
+
+    we will teach dgit to do
+       git-debrebase stitch
+
+3. git-debrebase push
+
+    like git push only does stitch first
+    ??? command line parsing!
+
+4. git-debrebase release
+
+    stiches, finalises changelog, signs tags, pushes everything
+    for the future, when there is some automatic builder
+
+will-overwrite for each ref
+    refs/heads/FOO
+is
+    refs/ffrebase/FOO
+
+========================================
+
 import from gbp
 
 [ all this is done now: