Subversion help
Contents |
[edit] 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
[edit] Graphical Subversion (for Windows users)
See this page for more info: Graphical Subversion (for Windows users)
[edit] Command Line Subversion (for Hackers)
[edit] Getting it
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 )
[edit] Using it
After installing the subversion client, go to a DOS prompt, and type the following command:
svn checkout svn://gilgamesh.HamsterRepublic.com/ohrrpgce/wip c:\ohrrpgce
You can check out the source code into any directory you want, c:\ohrrpgce is just the default.
[edit] Updating
After you have checked out a copy of the source code, you can update it any time by going to a DOS prompt and typing:
cd c:\ohrrpgce svn update
[edit] 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
[edit] 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
[edit] Learning more
To learn more ways to use subversion, type:
svn help
or read the subversion FAQ at http://subversion.tigris.org/faq.html
[edit] Browsing
If you just want to browse the repository without actually checking it out, you can use http://gilgamesh.hamsterrepublic.com/websvn/
