-
Notifications
You must be signed in to change notification settings - Fork 331
/
getcvscode.shtml
139 lines (117 loc) · 5.82 KB
/
getcvscode.shtml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
<head>
<meta name="generator" content=
"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.17), see www.w3.org">
<title>JMRI: Getting the OLD CVS Code - no longer
supported</title>
<meta name="author" content="Bob Jacobsen">
<meta name="keywords" content="JMRI technical code CVS download">
<!--#include virtual="/Style.shtml" -->
</head>
<body>
<!--#include virtual="/Header.shtml" -->
<div id="mBody">
<!--#include virtual="Sidebar.shtml" -->
<div id="mainContent">
<h1>JMRI Code: Getting the OLD CVS Code (Archived)</h1>
<h2>This page is kept for historical purposes only!</h2>
<p class="important">JMRI has migrated away from CVS for version control to
<a href="getsvncode.shtml">SVN</a> in July 2011, and on to
Git in September 2015. For access to the current JMRI source
code, please see the <a href="getgitcode.shtml">Git
repository</a> page.</p>
<p>JMRI release 2.12 (and earlier) were made from CVS, and to
access that source code, you should use the detailed
instructions below.</p>
<h2>Quick Start</h2>
<p>You can download the JMRI source code via CVS using:</p>
<pre>
<code>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri login
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri co all
</code>
</pre>(If asked for a password, just hit return)
<h2>Details</h2>
<p>Our source code up to JMRI version 2.12 was distributed
using CVS. (We also kept the <a href="WebSite.shtml">web
site</a> in CVS, if you'd like to work with it directly.) If
you want to work with the code, a few minutes installing CVS
is well worth it. We're sorry, but we just can't support
other methods (sending .zip files, etc), as they're just too
error prone.</p>
<p>Many computers come with CVS installed, including Linux
and Mac OS X. If you're using Windows, you will need to
install a CVS "client" program like <a href=
"http://sourceforge.net/project/showfiles.php?group_id=10072&release_id=24467">
WinCVS</a>. A recent version can be downloaded from: <a href=
"http://prdownloads.sourceforge.net/cvsgui/WinCvs120.zip">http://prdownloads.sourceforge.net/cvsgui/WinCvs120.zip</a>.</p>
<p>To get a copy of the source for your own use, you can use
"anonymous checkout". For a command line cvs client, make a
new directory for the project, change to it, and tell CVS you
exist with</p>
<pre>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri login
</pre>This "login" line is only needed once; after that, it is
remembered on your local machine. You may be asked for a password.
If so, just hit return, as the empty password will be accepted. You
can then get a copy of the code with
<pre>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri co all
</pre>
<p>If you're using a GUI-based client like WinCVS, pull down
the "admin" menu and select "command line" to get a place to
type these commands. On other computers, you can type them
directly on the command line.</p>
<p>If you have an existing copy of the code and want to
update it to the most recent contents of CVS, the second
command is:</p>
<pre>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri -q update -dA
</pre>
<p>See also the <a href="CVSFAQ.shtml">CVS FAQ page</a>.</p>
<p>After the checkout is complete, you'll find directories
called "xml", "resources", "jython", "help", "lib", "java"
and others. Change to the "java" directory. There, you will
find a "src" directory that contains the source code for JMRI
itself, and a "tests" directory that contains various test
routines.</p>
<p>You can look at the code with your favorite text editor.
To compile and run it, you need one of the compilation tools
described on the bar at the left.</p>
<p>Once you're working with the code, you'll probably create
some improvements you'd like to contribute back to the
project. This is where CVS has tremendous advantages; with
the appropriate permissions and commands, you can merge your
changes back into the common source automagically. Contact us
when you're ready to do that or see the <a href=
"index.shtml#contributing">info on contributing</a>.</p>
<h2>Windows Details</h2>
<p>Getting and updating the code with tortoisecvs</p>
<p>To get a initial checkout from CVS for your own use after
installing http://www.tortoisecvs.org/. Make a new directory
for the project, by creating a folder named "JMRISourceCode".
Right Click (control-click) on that folder and select CVS CVS
Checkout". In the pane that opens for the CVSROOT enter</p>
<pre>
<code><:pserver:jmri.cvs.sourceforge.net:/cvsroot/jmri></code>
</pre>For the Server enter
<pre>
<code>< jmri.cvs.sourceforge.net></code>
</pre>On the lower right of the screen is a "Fetch List" button.
Click that and a list will appear, click on the 'all' line. Then
Click "OK" on the bottom of the pane. A new pane will open and the
files will be downloaded; at the bottom of that pane is a check box
called "Close on Completion", check it. When the pane closes, the
folder you created will have folders inside it with all the JMRI
files.
<p>Once you have performed the initial checkout from CVS in
your local folder, to update them select all of them and then
Right Click and select "CVS Update". You can also just update
a single folder by selecting it, etc.</p>
<!--#include virtual="/Footer.shtml" -->
</div><!-- closes #mainContent-->
</div><!-- closes #mBody-->
</body>
</html>