docs/howtos/HowToFromcvs.mdwn

   1 ' **fromcvs** ' is a cvs to hg converter.
   2  This howto will show you how to test Simon 'corecode' Schubert's ***fromcvs***.
   3
   4 ----
   5
   6
   7
   8 ## What you need
   9
  10 ### Packages
  11 These packages are needed to run fromcvs.
  12
  13 *mercurial (devel/mercurial)
  14
  15 *git (devel/scmgit), if you want to convert to git
  16
  17 *rcsparse http://ww2.fs.ei.tum.de/~corecode/hg/rcsparse
  18
  19 *ruby (lang/ruby)
  20
  21 *ruby-rbtree http://www.geocities.co.jp/SiliconValley-PaloAlto/3388/rbtree/rbtree-0.1.3.tar.gz
  22
  23 ### Install
  24 First, install ruby and mercurial.
  25     > cd /usr/pkgsrc/lang/ruby
  26     # bmake install clean
  27     > cd /usr/pkgsrc/devel/mercurial
  28     # bmake install clean
  29
  30
  31 Or, if you prefer using binaries (requires a proper set PKG_PATH).
  32     # pkg_add ruby
  33     # pkg_add mercurial
  34
  35
  36 Install the ruby modules.
  37     > hg clone http://ww2.fs.ei.tum.de/~corecode/hg/rcsparse
  38     > cd rcsparse && ruby extconf.rb && make
  39     # make site-install
  40
  41
  42     > ftp http://www.geocities.co.jp/SiliconValley-PaloAlto/3388/rbtree/rbtree-0.1.3.tar.gz
  43     > tar xzf rbtree-0.1.3.tar.gz
  44     > cd rbtree-0.1.3 && ruby extconf.rb && make
  45     # make site-install
  46
  47
  48
  49 ## Using fromcvs
  50
  51 ### Basics
  52 Finally, get the program and run it!
  53     > hg clone http://ww2.fs.ei.tum.de/~corecode/hg/fromcvs
  54
  55
  56     > ruby tohg.rb <CVSROOT> <module> <hgdir>
  57
  58
  59 or
  60
  61     > ruby togit.rb <CVSROOT> <module> <gitdir>
  62
  63
  64
  65 ### Examples
  66 Convert the DragonFly source from your local cvs repo to your own mercurial repo:
  67     > hg init myhgrepo
  68     > ruby tohg.rb /home/dcvs src myhgrepo
  69
  70
  71 or for git
  72
  73     > mkdir hygitrepo && ( cd mygitrepo && git init --bare )
  74     > ruby togit.rb /home/dcvs src mygitrepo
  75
  76
  77
  78 ## Problems
  79 Report problems (fixes as well) to corecode.