Subversion help

This article (or part thereof) is obsolete. It may have made sense in the past, but it does not make sense now. It is kept here only for historic curiosity and/or posterity.

We are in the middle of a long-overdue migration to use git instead of svn as our main upstream repo. Any mentions of "Subversion" or "svn" are obsolete, and we are in the process of cleaning them up. Thank you for your patience!

Note: this page won't do you any good if you want to look at/work on the OHRRPGCE source code.

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)

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 )

Using it

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

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

Learning more

To learn more ways to use subversion, type:

svn help

or read the subversion FAQ at http://subversion.tigris.org/faq.html