README
100 lines
| 2.7 KiB
| text/plain
|
TextLexer
mpm@selenic.com
|
r445 | MERCURIAL QUICK-START | ||
mpm@selenic.com
|
r204 | Setting up Mercurial: | ||
mpm@selenic.com
|
r0 | |||
mpm@selenic.com
|
r204 | Note: some distributions fails to include bits of distutils by | ||
mpm@selenic.com
|
r205 | default, you'll need python-dev to install. You'll also need a C | ||
compiler and a 3-way merge tool like merge, tkdiff, or kdiff3. | ||||
mpm@selenic.com
|
r204 | |||
First, unpack the source: | ||||
mpm@selenic.com
|
r0 | |||
$ tar xvzf mercurial-<ver>.tar.gz | ||||
$ cd mercurial-<ver> | ||||
mpm@selenic.com
|
r204 | |||
mpm@selenic.com
|
r205 | To install system-wide: | ||
mpm@selenic.com
|
r204 | |||
$ python setup.py install # change python to python2.3 if 2.2 is default | ||||
mpm@selenic.com
|
r205 | To install in your home directory (~/bin and ~/lib, actually), run: | ||
mpm@selenic.com
|
r204 | |||
$ python2.3 setup.py install --home=~ | ||||
mpm@selenic.com
|
r507 | $ export PYTHONPATH=${HOME}/lib/python # (or lib64/ on some systems) | ||
$ export PATH=${HOME}/bin:$PATH # add these to your .bashrc | ||||
mpm@selenic.com
|
r205 | |||
mpm@selenic.com
|
r204 | And finally: | ||
mpm@selenic.com
|
r0 | $ hg # test installation, show help | ||
If you get complaints about missing modules, you probably haven't set | ||||
PYTHONPATH correctly. | ||||
Setting up a Mercurial project: | ||||
mpm@selenic.com
|
r445 | $ cd project/ | ||
mpm@selenic.com
|
r0 | $ hg init # creates .hg | ||
$ hg addremove # add all unknown files and remove all missing files | ||||
$ hg commit # commit all changes, edit changelog entry | ||||
Mercurial will look for a file named .hgignore in the root of your | ||||
Matt Mackall
|
r633 | repository which contains a set of regular expressions to ignore in | ||
file paths. | ||||
mpm@selenic.com
|
r0 | |||
Branching and merging: | ||||
Matt Mackall
|
r633 | $ hg clone linux linux-work # create a new branch | ||
mpm@selenic.com
|
r0 | $ cd linux-work | ||
$ <make changes> | ||||
$ hg commit | ||||
$ cd ../linux | ||||
mpm@selenic.com
|
r261 | $ hg pull ../linux-work # pull changesets from linux-work | ||
mpm@selenic.com
|
r445 | $ hg update -m # merge the new tip from linux-work into | ||
mpm@selenic.com
|
r261 | # our working directory | ||
Matt Mackall
|
r633 | $ hg commit # commit the result of the merge | ||
mpm@selenic.com
|
r0 | |||
Importing patches: | ||||
Fast: | ||||
$ patch < ../p/foo.patch | ||||
$ hg addremove | ||||
$ hg commit | ||||
Faster: | ||||
$ patch < ../p/foo.patch | ||||
$ hg commit `lsdiff -p1 ../p/foo.patch` | ||||
Fastest: | ||||
$ cat ../p/patchlist | xargs hg import -p1 -b ../p | ||||
mpm@selenic.com
|
r205 | Exporting a patch: | ||
(make changes) | ||||
$ hg commit | ||||
$ hg tip | ||||
28237:747a537bd090880c29eae861df4d81b245aa0190 | ||||
$ hg export 28237 > foo.patch # export changeset 28237 | ||||
mpm@selenic.com
|
r63 | Network support: | ||
mpm@selenic.com
|
r445 | # pull from the primary Mercurial repo | ||
Matt Mackall
|
r633 | foo$ hg clone http://selenic.com/hg/ | ||
foo$ cd hg | ||||
mpm@selenic.com
|
r1 | |||
mpm@selenic.com
|
r160 | # export your current repo via HTTP with browsable interface | ||
foo$ hg serve -n "My repo" -p 80 | ||||
mpm@selenic.com
|
r327 | # pushing changes to a remote repo with SSH | ||
foo$ hg push ssh://user@example.com/~/hg/ | ||||
mpm@selenic.com
|
r0 | # merge changes from a remote machine | ||
mpm@selenic.com
|
r261 | bar$ hg pull http://foo/ | ||
mpm@selenic.com
|
r445 | bar$ hg update -m # merge changes into your working directory | ||
mpm@selenic.com
|
r63 | |||
mpm@selenic.com
|
r160 | # Set up a CGI server on your webserver | ||
mpm@selenic.com
|
r445 | foo$ cp hgweb.cgi ~/public_html/hg/index.cgi | ||
foo$ emacs ~/public_html/hg/index.cgi # adjust the defaults | ||||
mpm@selenic.com
|
r969 | |||
For more info: | ||||
Documentation in doc/ | ||||
Mercurial website at http://selenic.com/mercurial | ||||
Mercurial wiki at http://selenic.com/mercurial/wiki | ||||