HowTo:Checkout CVS

From VsWiki
Revision as of 06:10, 21 March 2005 by Silverain (talk | contribs) (additional programs from old wiki)
Jump to: navigation, search
arrow_left.png none arrow_up.png HowTo none arrow_right.png

Checkout CVS Vegastrike

So you want to see what all the fuss is about, with people on the forums talking about some 'CVS' version of Vega Strike? Well, you've come to the right place. Or, you already know what CVS is, but you want to know what you need to get involved in the developmental side of this Open Source game...

CVS is an acronym for Concurrent Versions System. Basically, it allows many people to access a program's sourcecode on a remote server location. Anyone granted access to the source can download, run, alter and upload the sourcecode.

So what's it mean for Vega Strike? With the right tool to access CVS, you can access the data files for the latest developmental version of the game, download and play it. You can download the latest sourcecode of the game files themselves, and compile the game from scratch - that is, making an absolute cutting edge version of Vega Strike to run on your computer.

So why don't we all do this? Because the CVS version is the developmental version of the game. Any and all bugs, problems, hassles and destructive input is included. CVS may well not work, or not work very well. The advantage, though, is it gives you a view at what the developers are currently working on - so you know what they're talking about in the forums.

If you don't want to risk having an 'unstable' version of the game on your system, likely crashing itself or your computer, only download the stable 'release' versions of the game, accessed from the files locations off the homepage. But with delays between releases, sometimes its nice to see what's under the hood of the next release...

Modules

Please follow the directions on this page pertaining to your Operating System to obtain copies of the various modules (components) that make up the developmental version of Vega Strike.

These modules are (name as per CVS repository):

  • data4.x - Contains all gamedata required for Vega Strike. Also contains an unstable build of the Vega Strike engine and other associated program files.
  • music - The Music of Vega Strike is located separately.
  • vegastrike - The sourcecode to build your own copy of the Vega Strike engine.
  • (other modules to be listed)

Windows Clients

Tortoise CVS

Website

http://www.tortoisecvs.org/

Description

TortoiseCVS lets you work with files under CVS version control directly from Windows Explorer. It's freely available under the GPL.

With TortoiseCVS 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.

We seriously recommend that you review the website and program information to obtain some familiarity with Tortoise CVS.

Usage

Please be aware that the initial checkout of a module requires the download of ALL files within that module, which could easily be several hundred Mb plus. It must also obtain all the CVS registry details for those files, adding additional download time to the initial checkout. Later, when updating information, it only downloads those files that CVS registry notes as having been changed from your copy.

  1. Download and Install Tortoise CVS;
  2. Create a new folder in Windows Manager (called Sandbox, CVS or similar working location name);
  3. Within that folder, create another folder being the name of module you wish to checkout e.g. data4.x, music, vegastrike etc;
  4. Right click on the folder created and select CVS Checkout;
  5. Input the configuration information below into the CVS Module input area.
  6. Click OK to begin checkout of the module.

The CVSRoot line should look as follows: 

:pserver:anonymous@cvs.sourceforge.net:/cvsroot/vegastrike


Do not modify any files in this working directory, nor use it to actually play Vega Strike (if data4.x module). Instead copy the module to another location for play or development purposes. Retain the working folder in its original form for updating, that is obtaining the latest changes submitted by the developers.

To Update the information for a module:

  1. Right click on the folder;
  2. Select CVS Update:
  3. The program will examine the repository for any changes to the files you have, and only download those altered files.
  4. Recopy the directory to your play location.

Configuration

The following information should be input into the Graphical User Interface (GUI):

  • Protocol: Password server (:pserver)
  • Server: cvs.sourceforge.net
  • Port: <leave blank>
  • Repository Folder: /cvsroot/vegastrike
  • Username: anonymous
  • Module: <enter name of module as per Checkout CVS Vegastrike above.> E.g. data4.x

Cygwin

Linux Clients

LinCVS

I Ace123 have had troubles with this program because it seems to crash a lot for me. I use gCvs by the same people who make wincvs.

Website

  • get LinCVS from its homepage (just select the non-linux newest release on the left)-> static binaries -> lincvs-1.x.x-x-Win32-static_bin.zip
  • if you need the cvs.exe go here

Usage

  1. Download and Install LinCVS
  2. Start LinCVS
  3. Open Options->Profiles
  4. Enter the following data (examples):
    1. Name:VS
    2. User:anonymous
    3. CVS Server: cvs.sourceforge.net
    4. container: /cvsroot/vegastrike
    5. access: password
  5. Choose ADD and OK
  6. Open Project->Checkout
  7. Enter the following data (examples):
    1. Profile: Select your Vegastrike Profile (ie "VS")
    2. Checkout To: select your vegastrike working directory (e.g. c:\cygwin\home\yourusername)
    3. CVS Module: <enter name of module as per Checkout CVS Vegastrike above.> E.g. data4.x, vegastrike etc;
  8. Checkout As: whichever module selected;
  9. choose OK.

To Update your CVS-data:

  1. Select your project
  2. Open directory->update

gCvs 1.0

I think CVS is installed by default on most linux systems.

Website

get gCvs at http://cvsgui.sourceforge.net/

You might need GTK (probably have it if you have gnome) and Tcl (Yuck) - http://www.tcl.tk/software/tcltk/8.4.html

Usage

  1. Start gCvs;
  2. Go to Preferences in the Admin menu;
  3. Set CVSROOT to be the same as the one below. (or else the menus will be grayed out and you can't do anything);
  4. Go to Checkout Module in one of the menus and fill out the boxes appropriately. Set the compression level to 9 where possible (compression is one of the new features, so it may not be there);
  5. Type your password if needed;
  6. Open up a shell and type: 
cd vegastrike; ./configure <SEE HowTo:Compile from Cvs FOR DETAILS>; make

Repeat process to checkout the data4.x module

Mac Clients

arrow_left.png none arrow_up.png HowTo none arrow_right.png
Retrieved from "https://wiki.vega-strike.org/mediawiki/index.php?title=HowTo:Checkout_CVS&oldid=1225"