Subversion help
Contents
What is subversion?[edit]
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)[edit]
See this page for more info: Graphical Subversion (for Windows users)
Command Line Subversion (for Hackers)[edit]
Getting it[edit]
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 )
Using it[edit]
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.
Updating[edit]
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[edit]
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[edit]
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
Learning more[edit]
To learn more ways to use subversion, type:
svn help
or read the subversion FAQ at http://subversion.tigris.org/faq.html
