|
Size: 1549
Comment:
|
Size: 1939
Comment: Next part of tutorial series must be TutorialInit but not TutorialClone
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == ["Tutorial"] - getting started: installation == | == Tutorial - Getting started: Installation == ''(This page is part of the [[Tutorial]] series. Next part is TutorialInit)'' |
| Line 3: | Line 4: |
| Installing ["Mercurial"] is straightforward. | Installing Mercurial is straightforward. |
| Line 5: | Line 6: |
| * For Linux, Mac``OS X, and other Unix variants, follow the UnixInstall directions. | * For Linux, MacOS X, and other Unix variants, follow the UnixInstall directions. |
| Line 8: | Line 9: |
| Once we're done, we'll come back here. | Once you're done, come back here. |
| Line 10: | Line 11: |
| '''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. | 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 13: |
| 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 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 17: | Line 16: |
| $ hg basic hg commands (use "hg help -v" for more): }}} |
$ hg Mercurial Distributed SCM |
| Line 21: | Line 19: |
| {{{ | basic commands: |
| Line 25: | Line 24: |
| ... | 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 29: |
If this does not happen, there is something wrong with our installation, and we should take a look at InstallTroubleshooting. To determine what version of Mercurial you are running, type: |
To determine what version of Mercurial we are running, let's type: |
| Line 33: | Line 32: |
| $ hg version Mercurial version fa3578bfafbf+20050629 |
$ hg version Mercurial Distributed SCM (version 1.7.3) (see http://mercurial.selenic.com for more information) Copyright (C) 2005-2010 Matt Mackall 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. |
| Line 36: | Line 40: |
| Mercurial will need a username to use for recording commits. It's best to configure Mercurial to use your email address by creating a file `.hgrc`<<FootNote(http://www.selenic.com/mercurial/hgrc.5.html#files)>> in your home directory (or on Windows in `%USERPROFILE%\Mercurial.ini`, MercurialIni) containing lines like the following: | |
| Line 38: | Line 43: |
| Copyright (C) 2005 Matt Mackall <mpm@selenic.com> This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE |
[ui] username = John Doe <john@example.com> |
| Line 42: | Line 46: |
| If all has gone well, let's continue on to [[TutorialClone|TutorialInit]]. | |
| Line 43: | Line 48: |
| If all has gone well, let's continue on to TutorialClone. | ---- CategoryTutorial |
Tutorial - Getting started: Installation
(This page is part of the Tutorial series. Next part is TutorialInit)
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.7.3) (see http://mercurial.selenic.com for more information) Copyright (C) 2005-2010 Matt Mackall 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.
Mercurial will need a username to use for recording commits. It's best to configure Mercurial to use your email address by creating a file .hgrc1 in your home directory (or on Windows in %USERPROFILE%\Mercurial.ini, MercurialIni) containing lines like the following:
[ui] username = John Doe <john@example.com>
If all has gone well, let's continue on to TutorialInit.