#pragma section-numbers 2
= A Tutorial on Using Mercurial =
This tutorial is an introduction to using Mercurial.  We don't assume any particular background in using SCM software.

{i} You might first want to read UnderstandingMercurial

<<TableOfContents>>

== Introduction ==
After you work through this tutorial, you should have a grasp of the following:

 * The basic concepts and commands you'll need to use Mercurial
 * How to use Mercurial in simple ways to contribute to a software project

It is also strongly recommended that you have a look at the Mercurial man pages [[http://www.selenic.com/mercurial/hg.1.html|hg(1)]] and [[http://www.selenic.com/mercurial/hgrc.5.html|hgrc(5)]], which are also available in the [[http://www.selenic.com/mercurial/release/?M=D|release tarballs]] as {{{doc/hg.1.html}}} and {{{doc/hgrc.5.html}}}. You can also use `hg help <command>` on the command line.

The tutorial is split into the following pages:

 1. TutorialInstall - installing Mercurial
 1. TutorialInit - Initialize a [[Repository|repository]]
 1. TutorialClone - making a copy of an existing [[Repository|repository]]
 1. TutorialHistory - navigating the history of a repository
 1. TutorialFirstChange - making your first change
 1. TutorialShareChange - sharing changes with another repository
 1. TutorialExport - sharing changes with another person
 1. TutorialMerge - handling multiple independent changes to a file
 1. TutorialConflict - handling [[Merge|merges]] that need manual resolution
 1. TutorialConclusion - the end

== How to read this tutorial ==
The formatting convention is simple.  Command names and parameters are displayed in {{{fixed font}}}.

A line of input that you should type into your shell or command prompt is displayed in a fixed font, and the line will start with a {{{$}}} character.

A line of output that you should expect Mercurial or your shell to display is displayed in a fixed font, but with no special character at the start of the line.

{{{
$ this is a line of user input
this is a line of program output
}}}
We use the {{{bash}}} shell in all examples.  The concepts remain the same for other Unix shells and the Windows {{{cmd.exe}}}, but the syntax of some operations may change. For example, {{{ls}}} in a Unix shell is roughly equivalent to {{{dir}}} under Windows, and Unix {{{vi}}} is similar to Windows {{{edit}}}.

Now, let's begin with TutorialInstall.

== See also ==
 * [[UnderstandingMercurial|Understanding Mercurial]] - a graphical explanation of some Mercurial basics
 * [[BeginnersGuides|Beginner's Guides]]
 * http://mercurial.aragost.com/kick-start/ - A set of exercises for getting started with Mercurial by Martin Geisler
 * http://hginit.com/ - A tutorial by Joel Spolsky

----
CategoryTutorial

[[ChineseTutorial|Chinese]], [[CzechTutorial|Czech]], [[FrenchTutorial|French]], [[GermanTutorial|German]], [[ItalianTutorial|Italian]], [[JapaneseTutorial|Japanese]], [[KoreanTutorial|Korean]], [[LithuanianTutorial|Lithuanian]], [[BrazilianPortugueseTutorial|Português do Brasil]], [[SpanishTutorial|Spanish]], [[RussianTutorial|Russian]], [[UkrainianTutorial|Ukrainian]], [[ThaiTutorial|Thai]]