Getting started with Mercurial: A tutorial

The concluding part of this series will be the installation and typical usage of Tortoise Mercurial, a user friendly GUI front-end for Mercurial. It is commonly referred to as TortoiseHg (the chemical symbol for mercury).

This will be a fairly simple tutorial to follow as each description is followed by a screenshot. These screenshots were taken on Windows XP, but they will be pretty similar in other OSes

Download Tortoise mercurial from the Bitbucket site. There are installables for Windows as well as for Linux. Installation on Windows is fairly straightforward as it is wizard-based.

1. Create a new folder for keeping your art assets. This will be your project folder. In this screenshot (click for a larger image), I have created a project folder for the purpose of composing this series of blog posts. Simply right-click, and select ‘Create Repository here’ under the TortoiseHg sub-menu:

   

2. The defaults in the ‘Create Repository’ dialogs are fine. Just click Create.

   

3. The new repository has been created. That was easy, wasn’t it?

   

4. Now, enter the project folder and view the changes. On some OSes, you might see nothing here. These files are not intended to be seen or modified, hence they might be hidden. You can safely ignore them.

   

5. This is a screenshot of a new file that I am editing (using Emacs editor) inside the project folder. I am ready to check-in this file.

   

6. Now, you will need to add this new file to your repository. Let’s skip that and directly perform a commit. We will be later given a chance to add this file.

   

7. Here you can see our newly added file as unchecked. This means that this file is not yet under version control

   

8. Go ahead and mark the check box next to this file

   

9. In the edit box above, you can add a short comment about this commit. Since this is the initial commit, my comment is simply ‘First Commit’

   

10. Mercurial acknowledges the successful commit with the name(s) of the committed files

    

11. Notice that your file has a green tick icon indicating a successful check-in

    

12. Many hours and many check-ins later, my post is nearly close to completion. I commit this version as well.

    

13. In the commit dialog, notice the Repository Explorer in the menu.

    

14. You can view the history of changes in reverse chronological order. You can right click on any of them to compare the changes or revert back to an earlier version.

    

15. Simply clicking on each version will show the diff (in UNIX format) between the consecutive versions in the lower right window.

    

16. You can perform a revert by selecting the Revert option.

    

17. As indicated by the warning, your current file will be overwritten to an older version. But subsequently you can revert to the latest version as well, so this is not too much of an issue.

    

That’s pretty much all you need to know to use Tortoise Hg. Hope you found this series informative!