git-migration: README (NEW) - README file with description of conversion pr...

[draenog]

Author: draenog                      Date: Fri Jun 10 01:03:54 2011 GMT
Module: git-migration                 Tag: HEAD
---- Log message:
- README file with description of conversion process

---- Files affected:
git-migration:
   README (NONE -> 1.1)  (NEW)

---- Diffs:

================================================================
Index: git-migration/README
diff -u /dev/null git-migration/README:1.1
--- /dev/null	Fri Jun 10 03:03:54 2011
+++ git-migration/README	Fri Jun 10 03:03:47 2011
@@ -0,0 +1,26 @@
+To convert packages/* repositories from PLD CVS to git run:
+
+    ./pld-git.sh
+
+Conversion of CVS repos to git is done in the following steps.
+
+1. The modified version of cvs2git is cloned from github
+
+2. rsync is used to make a local copy of CVS repo
+
+   If REMOVE_BINARIES is set to yes the binary file are excluded. For an
+   exact pattern of excluded files see exclude_pattern in pld-git.sh
+
+3. The packages that have changed from last rsync are converted. For
+   conversion a modified version of cvs2git is used. 
+
+   Modifications to cvs2git:
+   
+   a. the algorithm to determine the parent branch of the given commit
+      is changed to give trunk smaller priority
+   b. the information about CVS revisions of changed files is added to
+      commit messages
+
+4. The new git repos are tweaked. For details see header of cvs2git_fixes.sh
+ 
+
================================================================