How to Set up Subversion Control in the Clarion IDE

Top  Previous  Next

These instructions assume that you first have TortoiseSVN GUI interface installed, This download can be found at the following link:

http://tortoisesvn.tigris.org/

More information regarding Subversion can be found at the following link:

http://tortoisesvn.tigris.org/

 

To use SVN in a stand-alone environment allowing a single developer to easily track versions of a product you do the following:

Configure the C7.1 IDE to monitor the directories where you want applications and dictionaries to be version controlled via Subversion. See the Binary File auto-export/import Tools Option to see how this is done.

Create the text files that will be stored in SVN. To create the text files for applications all you need to do is open the application and press the "Save & Close" button. To create the text files for dictionary files you will need to either manually export the dictionary to text or make a change to the dictionary so that the "Save" option is enabled. If you manually create the text file, don't forget to set the extension of the text file to the same extension the Dictionary monitor is configured to read/write (default is dcv).

 

Once you have created the text files you are ready to set up Subversion to track changes.

 

Create a directory to hold the SVN repository (i.e., E:\development\svn repository)

Right click on the new folder and select TortoiseSVN/Create repository here.

Go to the directory that is the root of your development. For example, if you put all of your applications in seperate directories below E:\development, then go to the E:\development folder.

Right click in the folder (not on any file or folder) and select SVN Checkout.

Set the URL of the repository to the folder where you created the SVN repository. The URL must start with file:/// and all slashes must be forward slashes. For example: ///E:/Development/SubVersion Repository.

Verify that the Checkout directory has not been changed (TortoiseSVN often adds a subfolder), and then click OK.

You will get a warning message that the target folder is not empty. Click Yes.

Right click in the folder (not on any file or folder) and select SVN Commit.

Tick (select) the files you want version controlled, and then click OK.. Normally the files you tick will be the solution (.SLN), project (.cwproj), application text (.apv) and dictionary text (.dcv) files.

 

To make it easier for you to find newly added files to your system, you should add files that you do not want in SVN to the SVN ignore list. You do this by right clicking on the file in the lower panel of the Commit dialog and select "Add to Ignore List". Alternatively, you can right click on your root folder in Windows and select Properties. You will see there is a new Subversion tab. Select that and then click on the Properties button. From the Property name dropdown select svn:ignore, then add file patterns (eg *.clw or *.app) to the Property values entry control. Ticking the "Apply property recursively" checkbox will apply the ignore filter to all child folder. This is a much faster way to set up the system if you have lots of directories that you are setting up.

 

The process is now complete . Next time you load a dictionary or application in the IDE you will see a History tab at the bottom of the window. When selected, it will show the history of the file. Further, right clicking on a file in the Solution view allows you access to SVN commands like commit or Diff.

If you add a dictionary file as a solution item you can then easily access the SVN commands for the dictionary. You can also open the dictionary directly from the Solution Explorer.