HowTo:Checkout SVN

From VsWiki
Revision as of 20:34, 20 April 2006 by Halleck (talk | contribs) (Mac OS X Clients: command line clients)
Jump to: navigation, search
arrow_left.png Edit News arrow_up.png HowTos Checkout CVS arrow_right.png

If you're interested in an experimental version of Vega Strike, then SVN is what you'll be looking at.

What is SVN?

SVN stands for Subversion, a system similar to CVS. It allows developers to simultaneously work on a centralised project - in this case, that's Vega Strike.

Downloading ("checking out") and compiling the SVN-version often gives you access to features not included in the latest stable release of the program. SVN-based versions can be unstable and may not even work at all, but may hold advantages compared to stable versions.

Modules

Vega Strike's SVN repository holds several subdirectories, which can either be checked out separately or altogether. The most notable ones are included below.

  • data - deprecated (FIXME ) data files.
  • data4.x - data files of the game. This consists mainly of models, textures and backgrounds. Required to play the game.
  • data5.x - FIXME Data for the upcoming version 5.
  • music - music for the game. The contents of this directory should go in [datadir]/music.
  • vegastrike - the game base code.
  • FIXME WRITEME: other modules


See also: Development:CVS Tree

Linux Clients

Command-line svn

Website

http://subversion.tigris.org/

Description

The linux-command `svn' is the most basic Subversion client.

Using svn for downloading vs-devel

Downloading the Vega Strike svn-modules is easy. The general syntax is

 svn co [repo]/trunk/[module] [target-directory]
 svn co https://svn.sourceforge.net/svnroot/vegastrike/trunk/vegastrike vegastrike

...will download the entire tree into directory `vegastrike'. In order to download single modules, a similar syntax can be used. For example, to download the data4.x-module,

 svn co https://svn.sourceforge.net/svnroot/vegastrike/trunk/data4.x data4.x

...will suffice. In order to get all the files required to compile the game, checkout the following modules:

  • data4.x
  • vegastrike
  • music (optional)

Windows Clients

Tortoise SVN

Website

http://tortoisesvn.tigris.org/

Description

Just like TortoiseCVS, Tortoise SVN lets you work with files under SVN version control directly from Windows Explorer. It's freely available under the GPL.

With TortoiseSVN you can directly check out modules, update, commit and see differences by right clicking on files and folders within Explorer. You can see the state of a file with overlays on top of the normal icons within Explorer. It even works from within the file open dialog.

Usage

  • Download and Install Tortoise SVN from http://tortoisesvn.tigris.org
  • Create a new folder in Windows Manager where you will download your modules (called Sandbox, SVN or similar working location name);
  • Within that folder, create another folder being the name of module you wish to checkout e.g. data4.x, music, vegastrike etc;
  • Right click on the folder created and select SVN Checkout. This brings up the checkout configuration screen;
  • Input the URL of the repository into the dialog box, for example data4.x will be;
  https://svn.sourceforge.net/svnroot/vegastrike/trunk/data4.x
    • You may also use the built-in repository browser to select the module you wish to check out.
  • Click OK to begin checkout of the module.

Other clients

FIXME WRITEME

Mac OS X Clients

Command Line Client

Website

http://metissian.com/projects/macosx/subversion/

(or http://pdb.finkproject.org/pdb/search.php?summary=svn for Fink packages.)

SCPlugin

Website

http://scplugin.tigris.org/

Description

"The goal of the SCPlugin project is to integrate Subversion into the Mac OS X Finder. The inspiration for this project came from the TortoiseSVN project."

Usage

Must have command line client installed.

FIXME -WRITEME

Other platforms

FIXME WRITEME


arrow_left.png Edit News arrow_up.png HowTos Checkout CVS arrow_right.png