packages: git-core/README (NEW) - README file with description of conversion

[draenog]

Author: draenog                      Date: Thu Jun  9 22:15:50 2011 GMT
Module: packages                      Tag: HEAD
---- Log message:
- README file with description of conversion

---- Files affected:
packages/git-core:
   README (NONE -> 1.1)  (NEW)

---- Diffs:

================================================================
Index: packages/git-core/README
diff -u /dev/null packages/git-core/README:1.1
--- /dev/null	Fri Jun 10 00:15:50 2011
+++ packages/git-core/README	Fri Jun 10 00:15:44 2011
@@ -0,0 +1,28 @@
+To convert packages/* repositories from PLD CVS to git call:
+
+    ./pld-git.sh
+
+Conversion of CVS repos to git ones 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 with a name deadbranch-... for branches
+   with names not longer registered in CVS. For details see header of
+   cvs2git_fixes.sh
+ 
+
================================================================