Work in progress.
Documentation for using SVN for C2C
A: Getting started:
1) Get a sourceForge login
2)
)Modders only) Tell Koshling what your SourceForge userid is, so he can add you as project contributors
3)Download and install Tortoise SVN if you don't already have it (
http://tortoisesvn.net/downloads.html)
4) Prepare a folder to contain your copy of the project
- Create an empty directory that will hold your working copy (i.e. - local directory on your machine which will be your 'image' of the central repository - this is where you will make your changes when you want to contribute them and where other people's changes will sync down to). I strongly recommend that this is NOT your 'live' copy in 'program files/firaxis/...'. Mine is in \development\C2C, but the location doesn't matter - just put it somewhere convenient where you have space.
- (Moders only) You can make changes here without effecting anyone else while you are developing them - the rest of us will only see them when you commit them (see later)
5) Checkout from the repository to the folder you created in (4). This will get the current revision (which I have initialised as the V13 content) and make a permanent connection between your working folder and the repository. Assuming you have installed SVN as in (2) you can do this by right-clicking the directory in Windows Explorer and selecting 'Tortoise SVN/Checkout...'. When it asks you for the repository URL enter.
6) After it's all copied you are up and running!
B: Getting the current version into play:
1) Create an empty folder somewhere not inside 'program files'
2) Right click and drag the root folder of your working copy to this new folder
3) Select the 'export without versioned files' option
4) Move the result into your mods folder (and rename it from C2C to Caveman2Cosmos)
C: (Modders only) Submitting updates
To make changes (once I have added you as a contributor) just edit files in your working copy and to sync them to the repository when they are ready, select them then right-click (in Windows Explorer) and select 'SVN Commit'. Please give a meaningful description of the change in the 'Description' box when doing this. To pull down other people's changes just do 'SVN update' on the root folder you created in (3) (or any subfolder if you know you are only after specific stuff). So we all stay in date I recommend we all do refreshes on the root quite frequently - before doing so you can use 'Tortoise SVN/Show log...' (usual right-click in Windows Explorer as is all SVN UI) on the root folder - that will tell you about any changes anyone has made so you'll have an idea of what a refresh would get (this list includes the description text for each revision, which is one reason why its important to provide a decent description when you do commits). I generally do a 'Show log' every day when I start (on AND currently since that was the only relevant SVN project until now) to keep up with what people are changing on an ongoing basis.
Old