Svn

From Freeciv

Coding | Remember | How to Contribute | Bug Reporting | Commit Rules | Source Tree Access | Help Wanted Forum | Known Bugs | Browse Source Tree | Testing tips | edit navbar

---

SVN is also known as Subversion.

Contents 1 How to get SVN 2 SVN documentation 3 Freeciv Project page 4 Freeciv source read access 4.1 How to fetch a copy of the SVN tree 4.2 After the first fetch, you only need to update 4.3 SVN tree browsing 5 Freeciv source read-write access for developers and translators 5.1 SVN tree access 5.2 How to fetch a copy of the SVN tree

[edit] How to get SVN

For Linux and UNIX users

You can get SVN from Tigris, or possibly from your distributor.

For Windows users

Preferably use TortoiseSVN.

[edit] SVN documentation

• Documentation for SVN.
• Quick CVS to SVN user guide.

[edit] Freeciv Project page

Freeciv project page at Gna!

[edit] Freeciv source read access

[edit] How to fetch a copy of the SVN tree

Here is how you can fetch what we called HEAD

$ svn co svn://svn.gna.org/svn/freeciv/trunk freeciv

This is how you can fetch what we call S2_0

$ svn co svn://svn.gna.org/svn/freeciv/branches/S2_0 freeciv-2.0

And this is how you can fetch what we call S2_1

$ svn co svn://svn.gna.org/svn/freeciv/branches/S2_1 freeciv-2.1

If you are behind firewall, which allows only connections on port 80

$ svn co http://svn.gna.org/svn/freeciv/trunk freeciv

[edit] After the first fetch, you only need to update

If you want to receive further updates, cd into the freeciv directory, then use svn update.

[edit] SVN tree browsing

You can see an interactive web listing of the tree here

http://svn.gna.org/viewcvs/freeciv/

You also can use svn ls to browse the tree like this

$ svn ls svn://svn.gna.org/svn/freeciv

[edit] Freeciv source read-write access for developers and translators

[edit] SVN tree access

1. Introduce yourself to the community.

   Subscribe to and send an introductory email to the freeciv-i18n mailing list, where you tell us a little about yourself and which language you want to take over translation of or add to Freeciv. You can find information on how to subscribe to our mailing lists under Community Forums.

2. Register an account.

   After you confirm the registration and log in, it is possible to request membership to the Freeciv project.
   

   See the Request for Inclusion box. The project name should be Freeciv.
   

   An admin will then review your membership request for approval.

3. Once you are a project member, you can get information on how to access the tree.

   From that page, you want to follow the instructions at Project Member SVN Access via SSH.

   Otherwise you will not be able to write your changes to the SVN tree.

   After you register your SSH key, it may take up to 1 hour for your SSH key to be processed by Gna!

IMPORTANT

Note that when you run 'ssh-keygen -t rsa' on your computer, you have to open ~/.ssh/id_rsa.pub, copy all the key (included ssh-rsa and user@host) and paste all this onto the page where the SSH Keys are registered at Gna. Then, in that Gna page, press the Update button and wait more than one hour. Once you have done this and you are sure that your registered key is exactly the same as the whole line in your ~/.ssh/id_rsa.pub containing that key, you need to checkout the project by using SVN+SSH this way:

Access to a numbered branch

export SVN_SSH=ssh

svn co svn+ssh://mkd@svn.gna.org/svn/freeciv/branches/SX_Y freeciv-X.Y

Access to the TRUNK (HEAD or CURRENT) tree

export SVN_SSH=ssh

svn co svn+ssh://mkd@svn.gna.org/svn/freeciv/trunk freeciv-trunk

After this, you have to do your changes in that tree and then commit by doing

svn ci

SVN will detect automatically which files are changed and so commit them if necessary.

In any SVN operation (such as 'update', 'commit', 'checkout' and so on) you should be asked to input your passphrase, which is a normal key which you typed the first time when using ssh-keygen. Not the ultralong key placed at your ~/.ssh/id_rsa.pub.

Note that OpenSSH software must be installed on your system in order to make this all work!

[edit] How to fetch a copy of the SVN tree

Here is how a user named kermit can fetch what we called HEAD

$ svn co svn+ssh://kermit@svn.gna.org/svn/freeciv/trunk freeciv

This is how a user named kermit can fetch what we call S2_0

$ svn co svn+ssh://kermit@svn.gna.org/svn/freeciv/branches/S2_0 freeciv-2.0

And this is how a user named kermit can fetch what we call S2_1

$ svn co svn+ssh://kermit@svn.gna.org/svn/freeciv/branches/S2_1 freeciv-2.1