SVN: RapidSVN Basics

Uniform Server 5.0-Nano. Subversion (SVN)

RapidSVN Basics

We currently have a complete SVN installation consisting of svn-win32 running on UniServer 5.0-Nano and the RapidSVN portable client.

This page provides a quick introduction to RapidSVN.

Browse existing repository

Bookmarks are shortcuts to existing repositories or working copies of a repository (or part).

Repositories can be located either on a remote or local server in this case a bookmark displays a URL to the appropriate repository.

For working copies a bookmark displays the absolute path to a corresponding folder.

Bookmarks: A bookmark is nothing more than a URL (remote/local server) or folder path (local) to a repository or working copy respectively. We currently do not have a local working copy however we do have a local repository installed on our portable server. If you remember the URL is http://localhost/svn/myproject/ Create book mark: Start UniServer C:\a_svn\UniServer\Start.exe Start PortableRapidSVN C:\a_svn\UniServer\svn_portable\PortableRapidSVN.exe 1) Click Bookmarks 2) From the dropdown menu select Add Existing Repository 3) Enter a repository URL http://localhost/svn/myproject 4) Click OK 5) Click a Bookmarks entry, displays folder tree. In the right window individual files are displayed

Top

Checkout - Get working copy

Checkout allows you to download either all or part of a repository to any folder. This folder and all folders downloaded into it become working folders.

A working folder contains a special tracking folder named .svn do not delete these folders. They are used by SVN to track changes and updates.

We already created an empty folder. This will be how working folder. C:\a_svn\UniServer\svn_working_copy In this example I do not want to download the entire repository only folder unicon and all its content. Create book mark & working copy: Start UniServer C:\a_svn\UniServer\Start.exe Start PortableRapidSVN C:\a_svn\UniServer\svn_portable\PortableRapidSVN.exe In bookmarks expand http://localhost/svn/myproject Expand folder trunk 1) Highlight folder unicon (left mouse click) Note: It is possible to skip this step. You will need to type the full URL to the folder at step 4) 2) Click Repository 3) From the drop down menu select Checkout - opens checkout form. 4) Enter full URL to folder unicon http://localhost/svn/myproject/unicon Note: Already filled in if you performed step 1) 5) Either type full path to working folder.     Or    Click button, navigate to working folder, highlight and click open. 6) Confirm box Add to bookmarks is ticked - Default 7) Click OK With a working copy downloaded. 8) Click Bookmarks entry (C:\a_svn\UniServer\svn_working_copy), displays folder tree of current working folder. In the right window individual files are displayed including their revision status. Right click on a file name, a context menu opens showing what actions you can perform on that file. See below for example.

Top

Commit changes

This final example shows how to edit a file and commit to the repository.

Edit: I want to edit file Run.bat contained in the docs folder. 1) In bookmarks expand working copy C:\a_svn\UniServer\svn_working_copy 2) Click Docs 3) Right Click Run.bat 4) From the drop down menu select Edit - opens notepad++. Make changes as required. Save file - Note icon changes color - indicates a modification Commit: 3) Right Click Run.bat 5) From the drop down menu select Commit - Opens a popup In the popup under Enter log message enter reason for change Click OK Note: Icon color reverts back to white Versions numbers are incremented. Log: Make a few more changes and commits. Now take a look at the log 3) Right Click Run.bat From the drop down menu select Log - Opens log viewer Select one of the versions - Note buttons to right are enabled. These are the actions that can be performed.

Top

Summary

The above provides a quick start guide to RapidSVN running with Uniform server more detailed information can be found on their Wiki.

Putting servers on-line the current configuration allows anyone to commit to your repository. The next page looks at restricting access.

Top

---