Veracity Q&A home login about faq

Where to begin?

asked Dec 15 '11 at 10:29

Jeremy%20Sheeley's gravatar image

Jeremy Sheeley ♦

edited Dec 15 '11 at 10:46


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:

Context Menu outside of a working copy

The Create Dialog

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:

  • Create a new repository.
  • Clone a remote repository.
  • You may also simply checkout a an existing local repository.

To create a new repository or clone a repository, choose <New Repository> from the Repository dropdown. If a repository is being cloned, or an existing local repository is being checked out, the Checkout Revision section will allow you to choose which revision or branch to use when setting up the working copy. For this document, I'll just create a new, empty repository.

Working inside explorer

Now that there is a Veracity Working Copy, the context menu has changed.

Context menu inside a working copy

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:

The Add dialog

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.

The Commit Dialog

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.

Creating 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.

Add from the commit dialog's context menu

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:

Normal file overlays

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.

  • Normal The file or folder is identical to the previous version in Veracity.
  • Added The file or folder has a been added to Veracity, but the add operation has not yet been committed.
  • Modified The file or folder has been modified, moved, or renamed.
  • Conflict The file or folder has a merge conflict that must be manually resolved. Use the context menu in the Commit dialog or the Status dialog to begin resolving conflicts.
  • Found The file or folder is not known by Veracity.
  • Ignored The file or folder is in the list of Veracity ignores.

Sharing Changesets

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.

Web Server

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.

The Sync dialog

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%20Sheeley's gravatar image

Jeremy Sheeley ♦

i just unzipped

what should i run or register to get what u call Tortoise ?

install.txt don't have a word on it

(Nov 24 '12 at 17:14) Arioch

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!



answered Mar 15 '12 at 11:21

braykov's gravatar image


edited Mar 15 '12 at 11:22

I don't know that the tortoise client allows the server to run in the background. You may want to submit this as a different request (new question) or look at these options:

(Mar 15 '12 at 15:49) Jace Browning

Anyway, clicking on the X button and on the Close button should trigger the same behaviour. So this is a bug. It should either ask in both cases or not ask and keep the server running.

(Mar 15 '12 at 16:53) braykov

You are correct, it is a bug. The X button should have the same behavior. Also, justus87's point is correct that we don't currently have a way to leave the server running without the dialog. I've logged a bug and a feature request for both of those. Would minimize to tray be acceptable to you?

(Mar 16 '12 at 09:10) Jeremy Sheeley ♦

@Jeremy Sheeley, "minimize to tray" works for me. It may also be nice to have a "start server with Windows" option somewhere.

(Mar 16 '12 at 09:20) Jace Browning

The tray sounds like a perfect option for the windows environment. Close and X when clicked should cause the following: 1) Show a message that: a) the server is running, b) this goes to the tray 2) The dialog is closed 3) An icon appears in the tray

2-click on the icon would bring back this dialog.

(Mar 16 '12 at 11:51) braykov

on mine I had to do http://MYMACHINE:8080//..ect

(Sep 17 '12 at 06:59) MichaelJennings
showing 5 of 6 show all

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


answered Nov 24 '12 at 11:24

Garry's gravatar image


edited Nov 24 '12 at 12:02

Your answer
toggle preview

Follow this question

By Email:

Once you sign in you will be able to subscribe for any updates here



Answers and Comments

Markdown Basics

  • *italic* or __italic__
  • **bold** or __bold__
  • link:[text]( "title")
  • image?![alt text](/path/img.jpg "title")
  • numbered list: 1. Foo 2. Bar
  • to add a line break simply add two spaces to where you would like the new line to be.
  • basic HTML tags are also supported



Asked: Dec 15 '11 at 10:29

Seen: 5,794 times

Last updated: Nov 24 '12 at 17:15

powered by OSQA