Installing from SVN in Linux

Initial Checkout

You can check out trunk to anywhere, I recommend ~/caspring.

svn co svn://svn.caspring.org/trunk ~/caspring

Installing latest stable version

make -C ~/caspring install-stable

Installing latest test version

make -C ~/caspring install-test

Getting Started With SVN in Windows

  1. Get some sort of SVN interface. This will allow you to "checkout" (i.e. download) the SVN version of CA. For Windows, I recommend Tortoise SVN. Download the appropriate version for your operating system and install it.
  1. Do a SVN Checkout of the CA SVN. In Windows, first create a folder in your Spring/Mods directory. Call it "CA.sdd". Then, right-click on the folder and select "SVN Checkout". In the box labeled "URL of Repository", put in the URL svn://svn.caspring.org/trunk/mods/ca . Leave everything else as-is and hit OK. This will start the download of the SVN version of CA.
  1. After the download completes, CA.sdd will contain all the files of the CA mod. Experiment with them as you wish. The symbols on the files will tell you how they match up against the SVN version you last downloaded.
  1. To update your SVN copy, right-click on CA.sdd and select SVN Update. This may not work completely if you have modified files. However, it will not erase your modifications. Note that your SVN copy is independent of your normal, CA Downloader copy; updating one does not update the other.
  1. To revert files to their original content, right-click on files or folders and select Tortoise SVN -> Revert. Tick all the files you want to revert.
  1. To play your SVN copy, select the mod "Complete Annihilation $VERSION". Note that you will not be able to play your version with anybody else unless they have the exact same files that you do.

Submitting Changes

Before submitting any changes, make sure that your SVN copy of CA is up-to-date and you have tested your version.

  • If you do not have commit access, you can create a patch. See Patches, below. Attach the patch to a new ticket. A dev will then review your ticket and commit it if it is approved.
  • If you do have commit access, you can commit directly. Right-click on CA.sdd and select SVN Commit. Enter a log message and select the files that you have changed and would like to include in the patch. Hit OK; caspring.org will ask you for a name and password. All names are lowercase! Enter this information and hit OK. After a delay (short for a non-mod commit, long for a mod commit), you will get a done message. You may want to download the new version via CA Downloader and test again to make doubly sure you have not introduced any crashbugs or the like.

Patches

One way to create a change is to use a patch. If you do not have commit access, this is the best way to submit a change. Even if you do have commit access, it can sometimes be a useful way to demonstrate a change, especially if you do not want to actually commit the change.

Creating Patches

  1. Right-click on CA.sdd and select Tortoise SVN -> Create Patch.
  2. In the box that pops up, select the files that you have changed and would like to include in the patch. Hit OK, then choose a place for the patch to be created.

Applying Patches

  1. Right-click on CA.sdd and select Tortoise SVN -> Apply Patch.
  2. Choose the patch file you would like to apply and hit OK.

Reverting Committed Changes

To revert changes that have already been committed, do the following:

  1. Right-click on the folder or files you want to revert.
  2. Select Tortoise SVN -> Show log...
  3. After Tortoise SVN fetches the revision data, you should see a list of revisions. Right-click on the one you are interested in and select "Revert to this revision" or "Revert changes from this revision".
  4. This will edit your local copy of ca.sdd accordingly. Commit to finish the reversion. As always, make sure you test first.