Subversion/Using TortoiseSVN

From ReactOS
Jump to: navigation, search

The TortoiseSVN client is a popular and our recommended SVN client for Windows. It nicely integrates into the Windows Explorer, so it's very easy to use.

Installation

Most users should be able to download and install TortoiseSVN from the above link fine. But if you have not run Windows Update in years, you may need to do so to get the latest Windows Installer (Version 3.1 or later is required).

After the installation, you have to restart your computer.

Checking out the sources

  • Create a folder, in which you want your source files to reside (for example "ros" or "ReactOS").
  • Then right-click this folder and choose SVN Checkout.

TortoiseSVN SVN-Checkout Menu.png

into the URL of repository box. If you want all components, just enter svn://svn.reactos.org/reactos/trunk .
Then hit the
OK button. TortoiseSVN SVN-Checkout InputDialog.png

Now all source files for the latest revision will be downloaded to your computer.

Once finished, you have all files ready for a fresh build using the ReactOS Build Environment.

Updating the sources

The next time you want to get the latest SVN revision you choose SVN Update.

TortoiseSVN SVN-Update Menu.png

Creating a diff/patch file

If you made changes to the code, you might want to submit them to the project. If you don't have commit (write) access to the SVN Repository, you should create a diff/patch file, which only contains your changes. Then file a bug in our Bugzilla and submit the patch.

For creating such a file, right-click the directory, which contains all changed files, choose TortoiseSVN and then Create patch.

Now you have to enter a file name for the patch file. You should choose a name that best describes the purpose of your patch.

Committing your changes

If you have commit (write) access, you can make changes to the repository. You can commit the local changes in your working copy by clicking on SVN Commit.

The following dialog will be opened then:

TortoiseSVN SVN-Commit InputDialog.png

Enter a commit message into the upper edit box and select the files you want to commit in the bottom box. If your commit belongs to a Jira Issue, enter the Issue ID (e.g. CORE-1234) into the upper right box. Then hit the OK button.

In the next dialog you will be asked for your username and password. Enter the appropriate information here and click on OK.

More information about SVN commit access can be found here.

More information