' **fromcvs** ' is a cvs to hg converter.
 This howto will show you how to test Simon 'corecode' Schubert's ***fromcvs***.

----



## What you need 

### Packages 
These packages are needed to run fromcvs.

*mercurial (devel/mercurial)

*git (devel/scmgit), if you want to convert to git

*rcsparse http://ww2.fs.ei.tum.de/~corecode/hg/rcsparse

*ruby (lang/ruby)

*ruby-rbtree http://www.geocities.co.jp/SiliconValley-PaloAlto/3388/rbtree/rbtree-0.1.3.tar.gz

### Install 
First, install ruby and mercurial.
    > cd /usr/pkgsrc/lang/ruby
    # bmake install clean
    > cd /usr/pkgsrc/devel/mercurial
    # bmake install clean


Or, if you prefer using binaries (requires a proper set PKG_PATH).
    # pkg_add ruby
    # pkg_add mercurial


Install the ruby modules.
    > hg clone http://ww2.fs.ei.tum.de/~corecode/hg/rcsparse
    > cd rcsparse && ruby extconf.rb && make
    # make site-install


    > ftp http://www.geocities.co.jp/SiliconValley-PaloAlto/3388/rbtree/rbtree-0.1.3.tar.gz
    > tar xzf rbtree-0.1.3.tar.gz
    > cd rbtree-0.1.3 && ruby extconf.rb && make
    # make site-install



## Using fromcvs 

### Basics 
Finally, get the program and run it!
    > hg clone http://ww2.fs.ei.tum.de/~corecode/hg/fromcvs


    > ruby tohg.rb <CVSROOT> <module> <hgdir>


or

    > ruby togit.rb <CVSROOT> <module> <gitdir>



### Examples 
Convert the DragonFly source from your local cvs repo to your own mercurial repo:
    > hg init myhgrepo
    > ruby tohg.rb /home/dcvs src myhgrepo


or for git

    > mkdir hygitrepo && ( cd mygitrepo && git init --bare )
    > ruby togit.rb /home/dcvs src mygitrepo



## Problems 
Report problems (fixes as well) to corecode.