git-debrebase: README.git-debrebase: diagrams of how to handle imports

[dgit.git] / README.git-debrebase

diff --git a/README.git-debrebase b/README.git-debrebase
index 6b92faf9e8201517de99ddfdac3fb1ff62449b72..cf0034558137b4c18288310b51b2f559d2d69023 100644 (file)
--- a/README.git-debrebase
+++ b/README.git-debrebase
@@ -99,3 +99,83 @@ 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!--%--/----E--->
+                         /          /         
+                        %          4          
+                       /          3           
+                      /          2            
+                     /          1             
+                    2*         &_             
+                   /          /| \            
+                  1          0 00 =XBCD               
+                 /                                    
+                /                                     
+                 --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     
+                                                                 
+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