Installing TortoiseSVN for repo access - quasics/quasics-frc-sw-2015 GitHub Wiki

Installing TortoiseSVN

TortoiseSVN is a tool that integrates directly with the Microsoft Windows File Explorer, allowing you to work with a repository via context menus (e.g., the menus that show up when you right-click on things) and affecting the icons that are shown for files/directories in Windows. It's one of the most commonly-used Subversion tools in the Windows world.

vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv

THIS IS VERY IMPORTANT: PLEASE READ AND FOLLOW THE FOLLOWING INSTRUCTIONS CAREFULLY.

IF YOU DO WHAT "JUST SEEMS OBVIOUS", THE INSTALL WILL COMPLETE, BUT YOU WILL WIND UP WITH SOMETHING THAT EITHER (A) WON'T WORK WITH GITHUB, OR (B) WON'T WORK WITH VISUAL STUDIO CODE, OR (MORE LIKELY) (C) BOTH.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

To install TortoiseSVN for version control:

  1. Go to the "Downloads" page for TortoiseSVN.
  2. Click on the link for the current version of the tools that are right for your machine (win32 for 32-bit machines, x64 for 64-bit machines).
    • The download should begin automatically.
  3. Run the downloaded installer.
  4. When the "Welcome" screen comes up, click the "Next" button.
  5. When the license screen comes up, click the "Next" button.
  6. (IMPORTANT) Make sure that the option to install the "Command-line tools" is enabled (i.e., doesn't have a red "X" next to it), along with the other default settings.
    • This is telling the installer to not just install the GUI/point-and-click tools, but also the ones that Visual Studio Code will be able to use.
  7. When the "Custom setup" screen comes up, click the "Next" button.
  8. When the "Ready to Install" screen comes up, click the "Install" button.
  9. If prompted by Windows/Windows Defender to approve the installation, go ahead and do so.
  10. If a "Files in Use" warning shows up, select the "Do not close applications" option and click the "OK" button.
    • Note that this warning screen may be shown more than once. If so, just repeat this step.
  11. After the install completes, click on the "Finish" button.
  12. If you were shown the "Files in Use" warning during the install, restart your machine.
  13. Right-click on an empty area of your desktop, and select "TortoiseSVN | Settings" from the menu that pops up.
  14. In the "Settings" dialog, select the "General" category in the list shown on the left-hand side.
  15. In the "General" settings panel shown on the right-hand side, click in the "Global Ignore Pattern" field, and add three more words at the end of the list of values shown: ".gradle build imgui.ini bin simgui*.json networktables.json" (without the quotes, but with a space both before and between them).
    • This is telling TortoiseSVN that the folders/files named ".gradle", "build", etc. aren't part of what should be stored in the repository. This is OK (and in fact is required), since these are created uniquely on each machine, and MUST NOT be checked into the repository.
  16. Click on the "OK" button to save the changes.