Differences between revisions 15 and 29 (spanning 14 versions)
Revision 15 as of 2008-11-05 22:15:27
Size: 1846
Editor: GeorgeReilly
Comment:
Revision 29 as of 2011-07-08 14:52:05
Size: 1921
Editor: 84
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== Tutorial - Getting started: installation ==

''(This page is part 1 of 9 of the [:Tutorial] series. Next part is [:TutorialClone])''
== Tutorial - Getting started: Installation ==
''(This page is part of the [[Tutorial]] series. Next part is TutorialInit)''
Line 7: 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 30: Line 29:
Line 35: Line 33:
Mercurial Distributed SCM (version 1.0) Mercurial Distributed SCM (version 1.7.3)
(see http://mercurial.selenic.com for more information)
Line 37: Line 36:
Copyright (C) 2005-2008 Matt Mackall <mpm@selenic.com> and others Copyright (C) 2005-2010 Matt Mackall and others
Line 39: Line 38:
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Line 41: Line 40:

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:
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 50: Line 46:

If all has gone well, let's continue on to TutorialClone.
If all has gone well, let's continue on to TutorialInit.

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.


CategoryTutorial

TutorialInstall (last edited 2011-07-08 14:52:05 by 84)