Introduction

Google Code uses Subversion (SVN) for version control. Subversion is widely considered as an improved versioning method over CVS. This Wiki page provides instructions on using a browser called SmartSVN or the command line to obtain files from the FDS-SMV SVN Repository.

Using SVN via the Browser SmartSVN

SmartSVN is available as freeware. A for-purchase version of SmartSVN is available that has additional capabilities, but for most users the free version will suffice. Note that other programs are available (list of some found here).

Adding the Repository to SVN

Here is a short video of the process outlined below. (Right-Click and Save the Quicktime .mov file)

• After installing SmartSVN, launch the program.
• The program will open with a Welcome to SmartSVN window. Select Check out project from repository.
• A Check Out Project window will open. Select Manage
• A Repository Profiles window will open. Select Add
• An Add Repository Profile window will open.
• Select HTTP for the protocol
• In the Server Name box type fds-smv.googlecode.com
• In the Repository Path box type /svn/trunk/FDS/trunk
• Click Next
• Select Anonymous for the SVN Login
• Click Next
• If you desire to see something other than the URL in Check Out Project window select Use This Profile Name and enter a name. 'FDS-SMV' would be suitable here.
• To check out the code follow the instructions in the next section.

Obtaining Files

The First Time

Once a project has been added to the repository it can then be checked out.

• After launching SmartSVN, select Check out project from repository
• A Check Out Project window will open. Using the drop down box select the FDS-SMV repository.
• Click Next
• SmartSVN will scan the repository in display a directory tree. The folders in the tree can be opened and closed with the plus/minus buttons.
• Expand the FDS folder, then select the 'trunk' folder under it.
• Click Next
• Type in or browse a Local directory where the files will be stored on your computer.
• Click Next

At this point, the entire FDS-SMV project will be copied from the repository to your computer.

After the First Time

• After launching SmartSVN, select Open Existing project(s):
• Select the Project Name you wish update
• Click OK
• You can now select either a file or a subdirectory and click the green arrow to update your local files from the repository.

Using SVN at the Command Line, without using SmartSVN client

If you have SVN command line client installed, you can check out the FDS/SVN repository using the command line version of SVN.

You can download the command line client for your platform here: http://subversion.tigris.org/project_packages.html

Open a terminal/shell session and change to the directory that you want the FDS-SMV project folder to be placed within. NOTE: the distinction between "https" and "http" below.

Anonymous Checkout

If you are not a member of the FDS-SMV development team, then type:

svn co http://fds-smv.googlecode.com/svn/trunk/FDS/trunk FDS-SMV

Developer Checkout

NOTE: Replace 'my_name' in the string below with your google account username. This is the same username that has been given Project Member status in Google Code.

As a member of the FDS-SMV development team with commit privileges, type:

svn co https://fds-smv.googlecode.com/svn/trunk/FDS/trunk FDS-SMV --username [dev. username]

You will be prompted for your password, but this is NOT the password for your Google Account, this is a special Google Code password that you can find through a link under the "Source" tab of the Google Code fds-smv project site. It will be a random bunch of numbers and letters and nothing that you can specify. NOTE: the link will not be available unless you are a Project Member or Owner.

Either way, a directory called FDS-SMV will appear in the directory where you executed the checkout command (the 'co' part of the string), with the contents of the FDS-SMV repository contained within.

Updates

To update your local copy of the repository, go to the sub-directory that you want to update (FDS-SMV in the example above) and type:

svn update

NOTE: This could be used to update any of the sub-directories under FDS-SMV. If you change down to a subdirectory, like 'SOURCE_FDS5' and execute the svn update command, only that directory will be updated.

Change or Commit Log

To obtain a log of transactions for that particular sub-directory, type:

svn log -r N:M > text_file.txt

Which will record all transactions from SVN revision N to M in the file text_file.txt By switching the order of the revision numbers you can sort the log in ascending or descending order by revision number.

Status

To see which local files are different from those in the Repository, type:

svn status | grep -v '?'

Info

To find out repository details such as the revision number or who made the last change use the svn info command.

For example, cd'ing into the Verification directory and typing svn info results in the following output:

Path: .
URL: https://fds-smv.googlecode.com/svn/trunk/FDS/trunk/Verification
Repository Root: https://fds-smv.googlecode.com/svn
Repository UUID: d1fd391b-682f-0410-ad1c-43d0e10d2734
Revision: 4274
Node Kind: directory
Schedule: normal
Last Changed Author: mcgratta
Last Changed Rev: 4246
Last Changed Date: 2009-06-25 16:42:34 -0400 (Thu, 25 Jun 2009)

Edit Existing Commit Log Entry

To edit an existing commit log entry (developers only):

svn propset -r N --revprop svn:log "[new log message]" https://fds-smv.googlecode.com/svn/trunk/FDS/trunk/ --username [dev. username]

This will replace the log entry for SVN revision N, with the text placed in quotes. Note, this command will prompt for your GoogleCode password, which is the password in your profile, and not your Google Account password.