freecol/www.freecol.org/documentation/subversion.html

47 lines
4.1 KiB
HTML

---
title: Subversion Usage
author: FreeCol Team
layout: page
folder:
path: /documentation/
name: Documentation
---
<div class="warningbox">FreeCol no longer uses Subversion. For the latest documentation on compiling FreeCol, please see our <a href="git.html" title="Git Repository">Git Repository</a>. This information is retained for historical reference.</div>
<p align="justify">Subversion is the tool we use for storing our source code in a central location. This system allows everyone to have their own copy of the source code. You can <a href="http://en.wikipedia.org/wiki/Subversion_(software)" target="wikipedia_subversion">read more about Subversion</a> at Wikipedia.</p>
<p>If you just wish to take a quick look at the the Subversion repository, you may use the web-based interface: <a href="https://sourceforge.net/p/freecol/code/">Browse Subversion Repository</a>.</p>
<h4>Development branches</h4>
<p>We are often developing two versions of FreeCol at the same time: the main/trunk version and a stable branch. The former will be released as FreeCol x.0 and will probably be buggy for some time, while the latter is used for creating stable releases. At other times however only the trunk is being worked on.</p>
<p><em>Read more on the <a href="subversion-repository-layout.html">Subversion Repository Layout</a></em></p>
<a name="latest" title="latest"></a>
<h4>Get the latest development version</h4>
<p align="justify">The stability of the trunk might be poor, but is recommended for users who are comfortable with Java development and who would like to test new features and report bugs. If more stability is desired, it is usually better to work from the current release.</p>
<p>You need a <a href="https://sourceforge.net/p/forge/documentation/svn/" target="sf_subversion">Subversion client</a> in order to get the development version of the game.
<p>
<strong>Main version:</strong>
<div>https://svn.freecol.org/svnroot/freecol/freecol/trunk</div>
</p>
<p>
<strong>Current release:</strong>
<div>https://svn.freecol.org/svnroot/freecol/freecol/tags/&lt;release&gt;</div>
</p>
<p>This is how you can get the versions using command-line subversion (refer to the application&#39;s documentation otherwise):</p>
<table border="0">
<tbody>
<tr>
<td width="20">&nbsp;</td>
<td>
<p class="cCode" align="left">
<em>Getting the main version:</em><br />
# svn co https://svn.freecol.org/svnroot/freecol/freecol/trunk freecol
<br /><br />
<em>Getting the 0.10.5 release:</em><br />
# svn co https://svn.freecol.org/svnroot/freecol/freecol/tags/0.10.5 freecol
</p>
</td>
</tr>
</tbody>
</table>
<p align="justify">The hash (#) represents your command-line prompt - don&#39;t include it :-)</p>
<p align="justify">In order to compile the game you will need a <strong>Java Virtual Machine version 1.8</strong> or higher from <a href="http://java.sun.com">Sun</a> or <a href="http://openjdk.java.net">OpenJDK</a> and <strong>a recent version of <a href="http://ant.apache.org">Ant</a></strong>.
</p>