wiki:SvnHints

Brief Overview to the Command Line SVN Client

This document is intended for plugin developers who can't or don't want to use the GUI-based TortoiseSVN client. It provides a brief overview on how to use the command line version of SVN on Windows 7 to sync code with the CrypTool 2 repository. The client can be downloaded at http://subversion.apache.org/packages.html#windows.

SVN Configuration

The global SVN configuration file config can be found at %APPDATA%\Subversion.

For use within the CrypTool 2 project the global ignore pattern needs to be enabled. Open the configuration file and look for global-ignores. Remove the "#" in front, to enable the option, and set the pattern at least to obj bin debug release *.pdb *.suo *.exe *.dll *.aux *.dvi *.log *.bak *.bbl *.blg *.user.

The next option will set an editor which is called during committal to add comments. Look for editor-cmd, remove the "#" and type the absolute path to the preferred program. In case of notepad the line would be editor-cmd = %windir%\system32\notepad.exe. Please comment every commit.

If allowed by the rights of the CrypTool 2 repository, the committal should work after the two options are set.

Source Download

The CrypTool 2 sources can be downloaded to a chosen folder in the following way:

  1. Navigate with the Explorer to the folder where the project should be downloaded to
  2. Shift + right click in an empty area and choose Open command window here from the context menu
  3. Type svn checkout https://www.cryptool.org/svn/CrypTool2/trunk/
    • Use anonymous as username and leave the password blank

Usage

The common workflow might look like indicated below:

  1. Navigate with the Explorer to the folder where changes were made
  2. Shift + right click in an empty area and choose Open command window here from the context menu
  3. Type svn update to update the local sources to the newest version of the remote repository
  4. Edit, add or remove files
    • Remember to use always the SVN file commands if you want to change whole files (e.g. use svn add to add files or svn delete to delete them)
    • Type svn status to see which files were changed
    • Type svn diff to see the changes at the command window
    • Type svn diff > diff.txt to write the changes to diff.txt
  5. Type svn commit to submit to the remote repository and add a comment to the changes (check in files)
    • Remote write commands require an active account at the CrypTool 2 repository

Further Information

Further references about SVN:

Last modified 9 years ago Last modified on Jun 18, 2012, 1:15:07 PM