git-debrebase: notes re psuedomerges

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/NOTES.git-debrebase b/NOTES.git-debrebase
index e0a67b5b3ea470d09614934c131e5fc7c8ddf675..0310f968dea2a2b0a085b4d40f17236318d54972 100644 (file)
--- a/NOTES.git-debrebase
+++ b/NOTES.git-debrebase
@@ -174,6 +174,36 @@ so that the overall result will be series of pseudomerges.
 
 ========================================
 
+So, pm handling specifics:
+
+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
+        either 1. one of them or, if there is no maximal one,
+        2. our tip
+
+        ? optionally, according to config always take tip anyway
+
+2. git-debrebase stitch
+
+    makes pseudomerge with will-overwrite
+    deletes will-overwrite
+
+========================================
+
 import from gbp
 
 [ all this is done now: