Put in remaining pages and wiki contents.
[ikiwiki.git] / 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.