Differences between revisions 59 and 61 (spanning 2 versions)
Revision 59 as of 2010-10-21 04:26:10
Size: 3236
Editor: mpm
Comment:
Revision 61 as of 2012-11-11 13:08:30
Size: 3221
Editor: abuehl
Comment: remove link to deleted page "SCM"
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
This tutorial is an introduction to using Mercurial. We don't assume any particular background in using SCM software.
Line 4: Line 5:
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]]
{i} You might first want to read UnderstandingMercurial
Line 11: Line 10:
After you work through this tutorial, you should have a grasp of the following:
Line 12: Line 12:
After you work through this tutorial, you should have a grasp of the following:
Line 20: Line 19:
 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
 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
Line 31: Line 31:
Line 42: Line 41:
Line 45: Line 43:
Now, let's begin with [[TutorialInstall]]. Now, let's begin with TutorialInstall.
Line 50: Line 48:
 * [[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
 * 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
Line 56: Line 54:
[[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]]
[[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]]

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

1. 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 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. TutorialInit - Initialize a repository

  3. TutorialClone - making a copy of an existing repository

  4. TutorialHistory - navigating the history of a repository

  5. TutorialFirstChange - making your first change

  6. TutorialShareChange - sharing changes with another repository

  7. TutorialExport - sharing changes with another person

  8. TutorialMerge - handling multiple independent changes to a file

  9. TutorialConflict - handling merges that need manual resolution

  10. TutorialConclusion - the end

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

3. See also


CategoryTutorial

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

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