What is subversion?
Subversion is a version control system. It provides a way to store a complete history of changes to a set of files, and also provides the ability to create "patches" and merge changes from different people. If you want to learn more about subversion, visit http://subversion.tigris.org/ . This page will focus on the simplest usage of subversion, which is using it to get the very latest version of the OHRRPGCE
Graphical Subversion (for Windows users)
See this page for more info: Graphical Subversion (for Windows users)
Command Line Subversion (for Hackers)
The latest version of subversion for windows can be downloaded from http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 (users of other operating systems should check http://subversion.tigris.org/project_packages.html )
After installing the subversion client, go to a CMD prompt, and type the following command:
svn checkout https://rpg.hamsterrepublic.com/source/wip c:\ohrrpgce
You can check out the source code into any directory you want, c:\ohrrpgce is just an example.
After you have checked out a copy of the source code, you can update it any time by going to a CMD prompt and typing:
cd c:\ohrrpgce svn update
Making a patch
If you have fixed a bug or cleaned up some messy code and you want to submit your changes to James, you can use subversion to create a patch.
cd c:\ohrrpgce svn diff > mypatch.txt
And then you can post mypatch.txt to bugzilla or e-mail it to James.
If you have changed a whole bunch of files, but you only want to submit a few of the changes as a patch, you can specify which files to include in the patch. For example, to make a patch that includes your changes to the battle system, but NOT changes to CUSTOM, you could type:
cd c:\ohrrpgce svn diff bmod.bas bmodsubs.bas > mypatch.txt
Knowing what you have changed
If you have lost track of what files you have changed, you can get a quick list by typing
cd c:\ohrrpgce svn status
- Any files that you have modified will be listed with the letter M
- Any files you have deleted will be listed with !
- Any files you have created that are not part of the source will be listed with ?
- Any files where you have made changes that conflict with a change made in the official sources will be listed with a C
To learn more ways to use subversion, type:
or read the subversion FAQ at http://subversion.tigris.org/faq.html