git-debrebase: abolish abbrev thing

[dgit.git] / README.git-debrebase

diff --git a/README.git-debrebase b/README.git-debrebase
index 6b92faf9e8201517de99ddfdac3fb1ff62449b72..fc96cd8269c80483cfcf806d201a8ac5d89cf72b 100644 (file)
--- a/README.git-debrebase
+++ b/README.git-debrebase
@@ -99,3 +99,85 @@ replaced.)
 For `3.0 (quilt)' the breakwater branch contains roughly what you
 would get if you untarred the origs and the debian.tar.gz, and then
 deleted all the patches without applying them.
+
+
+
+Consider a non-dgit NMU followed by a dgit NMU:
+                                              
+                                 
+                                              
+            interchange --/--B3!--%--/----D*-->                    
+                         /          /                      
+                        %          4                       
+                       /          3                        
+                      /          2                         
+                     /          1                          
+                    2*         &_                          
+                   /          /| \                         
+                  1          0 00 =XBC% 
+                 /                                                 
+                /                                                  
+                 --p--A---> breakwater                             
+          /                                                
+       --#--------> upstream                               
+                                                           
+                                                           
+ Key:                                                      
+                                                           
+    =XBC%     dgit tarball import of .debian.tar.gz containing   
+              Debian packaging including changes B C and patches 
+                                                                 
+    0         dgit tarball import of upstream tarball            
+                                                                 
+    00        dgit tarball import of supplementary upstream tarball
+                                                                 
+    &_        dgit nearly-breakwater import                              
+                                                                 
+    &'        git-debrebase converted import                             
+                                                                 
+    D'        git-debrebase converted debian/ changes import     
+                                      
+    * **      before and after HEAD
+                                 
+Want to transform this into:                                     
+                                                                 
+ I. No new upstream version (0 + 00 eq #)                               
+                                                                 
+                        --/--B3!--%--/------D*-------------/-->          
+                         /          /                    /       
+                        %          4                    4**      
+                       /          3                    3         
+                      /          2                    2          
+                     /          1                    1           
+                    2*         &_                   /            
+                   /          /| \                 /             
+                  1          0 00 =XBC%            /                    
+                 /                                       /                    
+                /                                       /             
+         --p--A-----B-----------------------C--D--->       
+          /                                                
+       --#----------------------------------------->       
+                                                           
+                                                           
+ II. New upstream (0 + 00 neq #)                                   
+                                                                 
+                                 interchange                     
+                                                                 
+                        --/--B3!--%--/------E*-------------/-->          
+                         /          /                    /       
+                        %          4                    4**      
+                       /          3                    3         
+                      /          2                    2          
+                     /          1                    1           
+                    2*         &_                   /            
+                   /          /| \                 /             
+                  1          0 00 =XBC%            /           
+                 /                               /                    
+                /                               /             
+         --p--A-----B--------------------p--C--D--->     
+          /                             /           
+       --#----------------------- - -  /  - - ----->
+                                      /
+                                     &'
+                                    /|
+                                   0 00