TortoiseSVN A Subversion client for Windows Version 1.4.52 Installing TortoiseSVN Click here to download the latest version of the Installer of 32bit TortoiseSVN Or Copy/paste the following link to your web-browser: http://tortoisesvn.net/downloads Once you have downloaded the TortoiseSVN client, you need to install this client on your system. Here are the steps to install TortoiseSVN client: - Locate the path where you have downloaded TortoiseSVN installer. - After the installation from the .msi file, you can start using TortoiseSVN. But a restart is recommended.3 TortoiseSVN User Guide Let us now learn to execute some basic Subversion features using TortoiseSVN. Once you install TortoiseSVN, you will find new options added to the Windows right click popup menu. The actions associated with TortoiseSVN will be available at the right click as shown below: Repository: A repository is a place where data is stored and maintained.Usually it is stored on the main server which contains data of all the projects. A client/user requires to access the repository to perform various actions like add/modify/delete etc. with the contents of their respective project. Working Copy: To use this Subversion client, or any other subversion client, we first need a local copy in our system of the repository contents. This local copy is also known as the 'Working copy'. This is where we make all modifications and then send these changes to the repository.4 Downloading a Repository to a Working Copy (SVN Checkout) 1. Create a folder in your system where you want to download (checkout) the repository contents. 2. Move your mouse to point at this folder, and do a right click 3. Select the 'SVN Checkout' option 4. A dialogue box as shown below opens up.5 This dialogue box requires you to enter the following details - URL of repository: Enter the repository URL here. svn://brown.usc.edu:3690/cs577a08/Team <#> where Team <#> is the team number. Note the space between Team and <#> For example, URL for team 1 is “svn://brown.usc.edu:3690/cs577a08/Team 1” 5. Authorization: 6. Enter your username and password in the authentication window, and click ok. Check the Save authentication box to avoid repetitive authorization. 7. Once username and password are authenticated, the repository files will be checked out into the working copy and a window like the one below will appear, and then click ok.6 8. When you open the working copy folder you will see icons with a green tick mark sign. If you encounter any other sign you can refer them by icon overlays mentioned in the end. Update the Working Copy To update the working copy with the latest repository modification we use the SVN Update command. It merges changes in repository with the working copy. 1. Right click on the folder/file 2. Select 'SVN Update'7 3. Click 'OK'8 Icon Overlays Now that you have checked out a working copy from a Subversion repository you can see your files in the windows explorer with changed icons. TortoiseSVN adds a so called overlay icon to each file icon which overlaps the original file icon. Depending on the Subversion status of the file the overlay icon is different. A fresh checked out working copy has a green checkmark as overlay. That means the Subversion Status is normal. As soon as you start editing a file, the status changes to modified and the icon overlay then Change to a red exclamation mark. That way you can easily see which files were changed since you last updated your working copy and need to be committed. If during an update a conflict occurs then the icon changes to a yellow exclamation mark. If you have set the svn: needs-lock property on a file, Subversion makes that file read-only until You get a lock on that file. Read-only files have this overlay to indicate that you have to get a lock first before you can edit that file. If you hold a lock on a file, and the Subversion status is normal, this icon overlay reminds you that you should release the lock if you are not using it to allow others to commit their changes to the file. This icon shows you that some files or folders inside the current folder have been scheduled to be deleted from version control or a file under version control is missing in a folder.9 The plus sign tells you that a file or folder has been scheduled to be added to version control. Unlike TortoiseCVS (the CVS shell integration) no overlay icon for unversioned files is shown. We do this because the number of icon overlays are limited system wide and should be used economically. Modify contents in the Subversion repository 1. Make the required modifications in the file/folder of your working copy. 2. A red exclamation overlay will appear on the modified file/folder. 3. Right click on the file that was modified. 4. Select the option 'SVN Commit'. 5. Enter a message. 6. Click 'OK'. 7. The red exclamation overlay on the modified file/folder will convert to a green tick mark overlay. Add a new file/folder to Subversion repository 1. In your working copy navigate to the folder where you want to add the new file/folder. 2. Add a new file/folder, for example meeting_7_21st_oct.doc 3. Right click on the file meeting_7_21st_oct.doc 4. Select TortoiseSVN - >Add10 5. The 'TortoiseSVN: Add' box will be displayed which will confirm the file that is to be added. Click 'OK' 6. The 'TortoiseSVN Add ... Finished!' box will be displayed with a success message. Click 'OK' 7. A blue plus overlay appears on the added file/folder. 8. To send this change from the working copy to the repository, you need to perform a 'Commit' operation. Right click on the file meeting_7_21st_oct.doc11 9. Select the option 'SVN Commit' 10. Enter a log message 11. Click 'OK' 12. The blue plus overlay on the added file/folder will turn to green tick mark. NOTE: The steps to add file or a folder or a folder tree are exactly the same. When you add a folder tree, it‟s enough you perform the above steps on the parent folder. The sub folders and files present in this folder are added and committed together with the parent.12 Delete a file/folder 1. Right click on the file/folder that you want to delete 2. Select TortoiseSVN - >Delete 3. A red
View Full Document
Unlocking...