Changes between Version 19 and Version 20 of TortoiseSVN_Guide
- Timestamp:
- Jan 2, 2011, 8:02:00 PM (13 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TortoiseSVN_Guide
v19 v20 4 4 == Definitions == 5 5 '''Subversion; SVN:''' [http://subversion.tigris.org/ Link] 6 6 7 * "A version control system that is a compelling replacement for CVS in the open source community." 7 * It records the history and manages changes to a repository of files by multiple users. 8 * It records the history and manages changes to a repository of files by multiple users. 8 9 * The programmers have been using a similar system called CVS for some time to manage our source code, and with SVN we've now rolled this out to include all game binaries/assets too. 9 10 * It takes care of ensuring that we don't overwrite each other's files when we commit files to it, and checks what you've already downloaded against what's in the repository so that it'll only download things that have changed since your last update. 10 11 11 12 '''TortoiseSVN:''' [http://tortoisesvn.tigris.org Link] 13 12 14 * "A free/open-source client for the Subversion version control system." 13 15 * An easy-to-use tool that integrates with Windows Explorer. It is used to access the Subversion repository. 14 16 15 17 '''Repository:''' 18 16 19 * Files are stored in a central repository. The repository is much like an ordinary file server, except that it remembers every change ever made to your files and directories. This allows you to recover older versions of your files and examine the history of how and when your data changed. 17 20 18 21 == Section 1: Creating Your Account == 19 20 22 For WFG members: Request an account from '''Erik Johansson''' (Feneur) or '''Philip Taylor''' (Ykkrosh). You will be given a User Name (typically your first name) and password. This will be used as your personal login to access the SVN repositories. 21 23 22 24 '''Note: Non-team members don't need an account to checkout the code, we've enabled read-only anonymous access.''' Team members need it to be able to commit, we cannot enable anonymous committing for obvious reasons. 23 25 24 25 26 == Section 2: Getting and Installing TortoiseSVN == 26 27 27 You can obtain TortoiseSVN from [http://tortoisesvn.net/downloads here]. Select the latest version available for your operating system. Follow the standard installation procedure and reboot when asked. 28 28 29 29 == Section 3: Making your first Checkout == 30 31 30 Now we need to point you to the correct SVN URL and checkout the current SVN source tree onto your harddrive. The current SVN trunk URL is: 32 31 33 32 http://svn.wildfiregames.com/svn/ps/trunk 34 33 35 Anonymous read-only access to non WFG members is at this URL: 34 '''Anonymous read-only access to non WFG members is at this URL:''' 36 35 37 36 http://svn.wildfiregames.com/public/ps/trunk 38 37 39 ''I also suggest creating a unique directory. I use the directory {{{C:\0ad}}}, but feel free to use whatever directory you see fit.''38 ''I also suggest creating a unique directory. I use the directory `C:\0ad`, but feel free to use whatever directory you see fit.'' 40 39 41 40 ''The directory you check the game out to should ideally have no spaces in its path. For example, C:\My Documents\0AD may cause problems.'' … … 47 46 '''2''' Right click to bring up the context menu. Select 'Checkout...' in the SVN section of the menu: 48 47 49 48 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide1.jpg)]] 50 49 51 50 '''3''' In the 'Url of repository' field ''enter the URL above''. Leave all other fields at their defaults: 52 51 53 52 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide2.jpg)]] 54 53 55 '''4''' After pressing OK, a dialog refering to caching the SVN server's host key could come up. Accept that key if it does. 54 '''4''' After pressing OK, a dialog refering to caching the SVN server's host key could come up. Accept that key if it does. 56 55 57 56 You should then be prompted for your account login. Enter the username and password you have requested. In some cases you may be asked for your password twice. … … 59 58 Once your password has been succesfully entered, you should see the repository beginning to download: 60 59 61 60 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide3.jpg)]] 62 61 63 62 Note: This will take a while. That's perfectly normal. You're checking out over a hundred megabytes of stuff. Leave it to get on with it, and go do something else for a while. … … 66 65 67 66 == Section 4: Updating your files == 68 69 67 A key component to any version control system is the ability to update your files to the latest versions available in the repository. Much like the rest of your everyday SVN operations, TortoiseSVN makes this extremely easy. The following steps will detail how this is done: 70 68 … … 73 71 '''2''' Right click to bring up the context menu. In the SVN section of the menu, select 'Update...': 74 72 75 73 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide10.jpg)]] 76 74 77 75 '''3''' You should immediately see a status dialog detailing what SVN is updating: 78 76 79 77 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide11.jpg)]] 80 78 81 79 The next two sections describe how to add to or change the repository contents, and are only available to accounts with write access (artists and programmers). 82 80 83 81 == Section 5: Making your first commit == 84 85 82 Once you have made some changes and are ready to check them in, you will need to commit them. You can commit an entire directory (and all of its sub-directories), a group of files, or a single file. Use the following steps to commit files to Subversion: 86 83 … … 89 86 '''2''' Right click to bring up the context menu. Select 'Commit...' in the SVN area of the menu: 90 87 91 88 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide4.jpg)]] 92 89 93 '''3''' Enter appropriate comments about the changes in the 'Enter Log Message' dialog: 94 (note that [http://trac.wildfiregames.com/wiki/SpecialCommands special commands] may be used to reference [http://trac.wildfiregames.com/wiki/HowToUseTrac Trac tickets].) 90 '''3''' Enter appropriate comments about the changes in the 'Enter Log Message' dialog: (note that [http://trac.wildfiregames.com/wiki/SpecialCommands special commands] may be used to reference [http://trac.wildfiregames.com/wiki/HowToUseTrac Trac tickets].) 95 91 96 97 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide5.jpg)]] 92 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide5.jpg)]] 98 93 99 94 '''4''' Press 'OK'. The commit should begin and you should see the following status dialog: 100 95 101 96 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide6.jpg)]] 102 97 103 98 == Section 6: Adding files to the repository == 104 105 99 Before you can commit a new file to the repository, you must first add it. Adding files to the repository is much like committing them, just use the following steps: 106 100 … … 109 103 '''2''' Right click to bring up the context menu. Under the 'TortoiseSVN' sub-menu, select the 'Add...' option: 110 104 111 105 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide7.jpg)]] 112 106 113 107 '''3''' Confirm which files you want to add to the repository: 114 108 115 109 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide8.jpg)]] 116 110 117 111 '''4''' Press 'OK'. You will see a status dialog detailing what was added to the SVN repository: 118 112 119 113 [[Image(http://www.wildfiregames.com/~code/resources/guide/guide9.jpg)]] 120 114 121 115 '''NOTE:''' To finalise the addition of files to the SVN repository you must '''Commit''' the files you added! Follow the section on Committing files above to see how that is done. … … 131 125 132 126 === A useful setting === 133 As you might have noticed (or in case you haven't checked out yet: will) the Thumbs.db files can cause some trouble when updating. They're Windows system files (hidden by default) that are different from computer to computer and thus causes trouble if people commit them. 134 There is a way to make Tortoise SVN ignore these files, but everyone has to edit the settings (more on that below) or just avoid committing these files of course, but as it's easy to do it by mistake here's some info on how to edit the settings. 135 127 As you might have noticed (or in case you haven't checked out yet: will) the Thumbs.db files can cause some trouble when updating. They're Windows system files (hidden by default) that are different from computer to computer and thus causes trouble if people commit them. There is a way to make Tortoise SVN ignore these files, but everyone has to edit the settings (more on that below) or just avoid committing these files of course, but as it's easy to do it by mistake here's some info on how to edit the settings. 136 128 137 129 [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-settings.html#tsvn-dug-settings-main] <-- there you can read about the general settings dialog. You can get to the General settings by right-clicking on a file/folder that's downloaded from SVN and there, in the Tortoise SVN submenu, left-click on Settings) The one we're interested in now is "Global ignore pattern", in that box please enter "Thumbs.db" (without the quotation marks, but with the capital T) and click confirm. 138