| | 1 | = How to Install TortoiseGIT on Windows = |
| | 2 | |
| | 3 | == Clean house first! == |
| | 4 | |
| | 5 | TortoiseGit installations are likely to fail if there is git related residue in your system from past installs of other git related packages. |
| | 6 | |
| | 7 | * If Cygwin Git, or any Git distribution other than msysGit, is installed on your system, uninstall it. |
| | 8 | |
| | 9 | * From the command prompt, type "git help". Verify that you get "'git' is not recognized as an internal or external command, operable program or batch file." If instead you get a help screen, you've still got a version of git installed somewhere. This is likely to cause trouble - uninstall it. If you've got msysGit, that's OK if it is an up-to-date version installed in the default location. |
| | 10 | |
| | 11 | * Search your system for any files named ".gitconfig" and either delete them or rename them. |
| | 12 | |
| | 13 | == Install the prerequisites == |
| | 14 | |
| | 15 | * Install Cygwin if needed. Verify PATH is set such that ssh.exe is found. |
| | 16 | |
| | 17 | * Install msysGit. Get it from http://code.google.com/p/msysgit/downloads/list |
| | 18 | |
| | 19 | Select "Run Git from the Windows Command Prompt" option from the "Adjusting you PATH environment" dialog. |
| | 20 | |
| | 21 | Select "Checkout as-is, commit as-is" from the "Configuring the line ending conversions dialog". |
| | 22 | |
| | 23 | Click Finish. |
| | 24 | |
| | 25 | * Install TortoiseGit. Get it from http://code.google.com/p/tortoisegit/downloads/list |
| | 26 | |
| | 27 | Start | All programs | TortoiseGit | Settings -> Select Git | Config and enter your Name and Email address. Click "Edit global .gitconfig, and then answer Yes when asked if you would like to create this file. Click Apply back on the Settings dialog. (If you click "Edit global .gitconfig" again, you will now see your User Info. Click OK to exit the Settings dialog. |
| | 28 | |
| | 29 | * Confidence test - Clone a repository from GitHub. |
| | 30 | * Start Windows Explorer |
| | 31 | * Create a new directory named "btree" |
| | 32 | * Right click on btree. Context menu should include several Git related entries; click on "Git clone" |
| | 33 | * Enter URL: git://github.com/Beman/Boost-Btree.git Note that form of URL is for a read-only checkout. |
| | 34 | * Click OK, and the local repository should be created. |
| | 35 | * Browse the directories and files, and the familiar icons should appear; TortoiseSVN and TortoiseGIT use the same icon overlays. |
| | 36 | * Modify a file, then commit the change. Because this is Git, you are committing to the local repository. |
| | 37 | * Try a push to the remote repository; it will fail because you did a read-only clone. |
