Copyright © Curt Hill Tortoise SVN A Subversion Client

Copyright © Curt Hill Introduction There are least two Tortoise Windows version control clients This presentation deals with the Subversion one –There is also a Mercurial one Both of these are shell extensions –An add in to Windows Explorer –AKA File Explorer Most actions come from a right click and menu choice on a directory

Getting The TortoiseSVN is free Obtain at Source Forge among others I downloaded an MSI file Double click and its installed Copyright © Curt Hill

Usage Once installed it is a shell extension –An add-in to Windows explorer There will also be a start menu entry to give access to some other features Our first task is to create a repository This is done by right clicking a directory that will contain the new repository Copyright © Curt Hill

Creating Copyright © Curt Hill

This Happens Next Copyright © Curt Hill

Resulting Directory Copyright © Curt Hill

Filling the Repository What do we want in the repository? Two options –Import an existing subversion repository –Populate it with a new project Copyright © Curt Hill

Import The import process is to make a source directory part of the repository This is the initial check in Recall that there are certain files that should not be checked –Anything that can be generated Subversion has a set of files that it will not check in but this may not be right –Found in preferences Copyright © Curt Hill

Preferences Copyright © Curt Hill

Importing a Project Clean the directory structure –Remove anything that is pointless to commit Right click on the directory to import Enter the URL of the repository Consider the following screens Copyright © Curt Hill

Adding crdp directory Copyright © Curt Hill

Next Copyright © Curt Hill

Results Copyright © Curt Hill

Now What? The repository is now tracking things However, there is nothing to track until some changes are made Changes are handled by the process: –Check out code –Modify/test –Commit (or check in) Copyright © Curt Hill

Process Right click on directory you wan things stored Choose SVN Checkout Fill in the dialog box items As the following screens show, the directory is d:\temp and repository is one created earlier Copyright © Curt Hill

Check Out Copyright © Curt Hill

Next Copyright © Curt Hill

Finished Copyright © Curt Hill

Dialog Box The output directory is called the sandbox –This is where we will work on the code before check in Since fully recursive was checked, the entire directory tree is extracted There is some discrepancies in sizes and files between the original, the repository and the new Copyright © Curt Hill

Files DirectoryFilesDirectoriesSize Original Repository M Sandbox M Copyright © Curt Hill Subversion is still holding onto the new directory Keeping track of what will become of the files in it

Development Normal development now ensues Edit files Compile Test Repeat until you are happy Then put them back in Copyright © Curt Hill

Changes have occurred Copyright © Curt Hill

Starting Commit Copyright © Curt Hill

Next Copyright © Curt Hill

Commit Finished Copyright © Curt Hill

File Status Every file in the sandbox has one of four possible statuses: Unchanged and current Repo and local version match Changed and current An update awaiting a commit Unchanged and out of date Repository version of this has been updated Changed and out of date Both local and repository have been independently updated Copyright © Curt Hill

Finally That is the cycle Check out Change Commit You do not need to check out again –Instead several commits may be done Copyright © Curt Hill