Differences between revisions 1 and 57 (spanning 56 versions)
Revision 1 as of 2005-08-26 00:58:28
Size: 2091
Editor: waste
Comment:
Revision 57 as of 2010-10-15 05:33:06
Size: 3238
Editor: abuehl
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
''You might first want to read [[UnderstandingMercurial]]''
Line 3: Line 5:
This tutorial is an introduction to using ["Mercurial"]. We don't assume any particular background in using ["SCM"] software.
This tutorial is also available in French, following ["FrenchTutorial"] and in Spanish, following ["SpanishTutorial"].
This tutorial is an introduction to using Mercurial. We don't assume any particular background in using [[SCM]] software.
Line 7: Line 8:
 * The basic concepts and commands you'll need to use ["Mercurial"]
 * How to use ["Mercurial"] in simple ways to contribute to a software project
 * The basic concepts and commands you'll need to use Mercurial
 * How to use Mercurial in simple ways to contribute to a software project
Line 10: Line 11:
It is also strongly recommended that you have a look at the Mercurial man pages hg(1) and hgrc(5) which are in the source tree as doc/hg.1.txt and doc/hgrc.5.txt 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. [[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
Line 14: Line 27:
The formatting convention is simple. Command names and parameters are displayed in ''fixed font''. The formatting convention is simple. Command names and parameters are displayed in {{{fixed font}}}.
Line 16: Line 29:
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 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.
Line 18: Line 31:
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. 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.
Line 21: Line 34:
 $ this is a line of user input
 this is a line of program output
$ this is a line of user input
this is a line of program output
Line 25: Line 38:
We use the ''bash'' shell in all examples. The concepts remain the same for other Unix shells and the Windows ''command.exe'', but the syntax of some operations may change. For example, ''ls'' in a unix shell is roughly equivalent to ''dir'' under MS Windows, and unix ''cat'' is similar to MS Windows ''type''. 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}}}.
Line 27: Line 40:
== Table of contents == Now, let's begin with [[TutorialInstall]].
Line 29: Line 42:
 * TutorialInstall - installing ["Mercurial"]
 * TutorialClone - making a copy of an existing ["Repository"]
 * TutorialHistory - navigating the history of a ["Repository"]
 * TutorialFirstChange - making your first change
 * TutorialShareChange - sharing changes with another ["Repository"]
 * TutorialExport - sharing changes with another person
 * TutorialMerge - handling multiple independent changes to a file
 * TutorialConflict - handling ["Merge"]s that need manual resolution
 * TutorialConclusion - the end
== Translations ==

Work to translate the Tutorial into the following languages has been contributed (in alphabetic order):<<BR>>

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

Note that these translations may lag behind compared to the English version.

== Other tutorials ==
 * [[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

You might first want to read UnderstandingMercurial

A tutorial on using Mercurial

This tutorial is an introduction to using Mercurial. We don't assume any particular background in using SCM software.

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 hg(1) and hgrc(5), which are also available in the 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

  2. TutorialClone - making a copy of an existing repository

  3. TutorialHistory - navigating the history of a repository

  4. TutorialFirstChange - making your first change

  5. TutorialShareChange - sharing changes with another repository

  6. TutorialExport - sharing changes with another person

  7. TutorialMerge - handling multiple independent changes to a file

  8. TutorialConflict - handling merges that need manual resolution

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

Translations

Work to translate the Tutorial into the following languages has been contributed (in alphabetic order):

Chinese, Czech, French, German, Italian, Japanese, Korean, Lithuanian, Brazilian Portuguese, Spanish, Russian, Ukrainian, Thai

Note that these translations may lag behind compared to the English version.

Other tutorials


CategoryTutorial

Tutorial (last edited 2013-09-02 17:41:09 by LeonardoPostacchini)