Subversion help

From OHRRPGCE-Wiki
Jump to navigation Jump to search

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