Tortoise clients are a popular GUI interface for version control on windows. Many people like having the ability to manipulate their version control programs from inside the Windows Explorer interface. The Veracity Tortoise client is a little different from other Tortoise clients, so this document will guide users through the transition.
The context menu
The initial point of interaction for most operations is the Windows Explorer context menu. Outside a Veracity working copy, the context menu will look like this:
The Create Dialog
The first dialog most people will use is the Create Working Copy dialog. The operations that you can do while creating a new working copy with this dialog are:
To create a new repository or clone a repository, choose
Working inside explorer
Now that there is a Veracity Working Copy, the context menu has changed.
Note that all operations are available from the context menu, regardless of the working folder contents. Operations are only removed from the context menu based on the number of items currently selected (for example, you can't simultaneously rename multiple files).
For the purpose of this tutorial, we'll create two new files. Right-click one of the files and choose Add. The Add dialog will look like this:
In the Add dialog, click Ok with only one of the files selected (this will make sense in a minute, promise).
The Commit Dialog
Now to commit our first changeset. From the Windows Explorer context menu, choose Veracity Commit.
Since this is a new working folder and repository, you will need to set a user before you can commit. Click the "set current user link" to bring up the settings dialog. Enter your username, and click OK in the settings dialog. You will be prompted to create the user.
Now, back in the Commit dialog, you will notice that one file is Added, and one file is still Found. Let's fix that, by right-clicking the Found file, and Choose Add from the context menu. I told you that it would make sense. The context menu for the commit dialog has lots of useful operations, such as reverting changes, deleting Found files or diffing modified files.
While you're in the commit dialog, take a look at the Branch tab. That's where you can choose to associate this changeset with a particular branch, or commit it without a branch. The default branch is master, and that's ok.
Now commit your two added files. Don't forget to enter a change set comment.
Back to Windows Explorer
Returning to Windows Explorer, you should see this:
Your files should be a pretty green color. If you ever feel like the icons haven't refreshed properly in Explorer, you can use the F5 key in Windows Explorer to refresh the icons.
Here's the list of icons that you can expect to see in Veracity's Tortoise client, and how they map to Veracity's working copy status.
Sharing is important. Let's make sure that other people get access to our new changeset. Start up the Web Server dialog from the Windows Explorer context menu.
Because we want to share our new repository with someone else, we'll have to Stop the server that was automatically started. Now make sure that the "Only accept connections from this computer" is unchecked, and use the Start button to restart the web server.
Now another person is free to clone from your machine using the URL http://YOURMACHINE/repos/YOURREPONAME. They can use the same Create Working Copy dialog as you used above. Once the repository exists on two different computers, you can use the Sync Dialog to transfer changesets between the computers.
The Sync Dialog
When you wish to transfer changes from one computer to another, you use the Synchronize dialog. The other computer must have the Web server running in order to participate the pushing or pulling of changesets.
Some things to note about the Synchronize dialog are that the Operation dropdown lets you choose to Push or Pull changes. Also, the Areas text box lets you choose to synchronize only some components (pushing work item changes without including version control changes, perhaps).
Now you've gotten the basics under control.
answered Dec 15 '11 at 10:43
Jeremy Sheeley ♦
When I hit Close in the Veracity Web Server dialog, it asks me if I am sure I want to stop the server. Actually I don't want to stop it, but just close the window. Should it behave like this? Does it mean I have to keep that window open? If so, then why does it not say anything when I close the window using the top X button. It closes the window and it stops the server w/o notification of any kind!
These two pictures might be worth 1,000 words. It took me quite a while to find how to access Veracity. Initial reaction: Impressive program. Still investigating if it will suite my needs.
Double click on my username to get to my testrepo: Picture 1
Right click to get the menu containing Veracity. Picture 2