|
Size: 1702
Comment: +cat
|
Size: 1846
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == Tutorial - getting started: installation == | == Tutorial - Getting started: installation == |
| Line 3: | Line 3: |
| Installing ["Mercurial"] is straightforward. | ''(This page is part 1 of 9 of the [:Tutorial] series. Next part is [:TutorialClone])'' Installing Mercurial is straightforward. |
| Line 10: | Line 12: |
| '''Note:''' This tutorial assumes you are running a version of ["Mercurial"] later than 0.6. In other words, if you have the 0.6 release, the tutorial will not work for you. This tutorial was last updated for ["Mercurial"] 0.9.1. | The Mercurial program is named {{{hg}}}. Every Mercurial command starts with {{{hg}}}, followed by the command name, followed by any relevant options and arguments. |
| Line 12: | Line 14: |
| The ["Mercurial"] program is named {{{hg}}}. Every ["Mercurial"] command starts with {{{hg}}}, followed by the command name, followed by any relevant options and arguments. Now that ["Mercurial"] is installed, we should be able to simply type {{{hg}}} at the prompt, and the program should display some helpful command summaries: |
Now that Mercurial is installed, we should be able to simply type {{{hg}}} at the prompt, and the program should display some helpful command summaries: |
| Line 20: | Line 20: |
| basic commands (use "hg help" for the full list or option "-v" for details): | basic commands: |
| Line 25: | Line 25: |
| (...) | commit commit the specified files or all outstanding changes (...) use "hg help" for the full list of commands or "hg -v" for details |
| Line 27: | Line 30: |
If this is not the case, there is something wrong with your installation, and you should take a look at InstallTroubleshooting. |
|
| Line 34: | Line 35: |
| Mercurial Distributed SCM (version 0.9.1) | Mercurial Distributed SCM (version 1.0) |
| Line 36: | Line 37: |
| Copyright (C) 2005 Matt Mackall <mpm@selenic.com> | Copyright (C) 2005-2008 Matt Mackall <mpm@selenic.com> and others |
| Line 38: | Line 39: |
| warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE }}} By default Mercurial uses a username of the form `user@localhost` for [:Commit:commits]. This is often meaningless. It's best to configure a proper email address in `~/.hgrc` (or on Windows in `%USERPROFILE%\Mercurial.ini`, MercurialIni) by adding lines such as the following: {{{ [ui] username = John Doe <john@example.com> |
| Line 42: | Line 52: |
Tutorial - Getting started: installation
(This page is part 1 of 9 of the [:Tutorial] series. Next part is [:TutorialClone])
Installing Mercurial is straightforward.
For Linux, MacOS X, and other Unix variants, follow the UnixInstall directions.
On Windows, follow the WindowsInstall instructions.
Once you're done, come back here.
The Mercurial program is named hg. Every Mercurial command starts with hg, followed by the command name, followed by any relevant options and arguments.
Now that Mercurial is installed, we should be able to simply type hg at the prompt, and the program should display some helpful command summaries:
$ hg Mercurial Distributed SCM basic commands: add add the specified files on the next commit annotate show changeset information per file line clone make a copy of an existing repository commit commit the specified files or all outstanding changes (...) use "hg help" for the full list of commands or "hg -v" for details
To determine what version of Mercurial we are running, let's type:
$ hg version Mercurial Distributed SCM (version 1.0) Copyright (C) 2005-2008 Matt Mackall <mpm@selenic.com> and others This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE
By default Mercurial uses a username of the form user@localhost for [:Commit:commits]. This is often meaningless. It's best to configure a proper email address in ~/.hgrc (or on Windows in %USERPROFILE%\Mercurial.ini, MercurialIni) by adding lines such as the following:
[ui] username = John Doe <john@example.com>
If all has gone well, let's continue on to TutorialClone.