rev |
line source |
bos@85
|
1 \chapter{Installing Mercurial from source}
|
bos@85
|
2 \label{chap:srcinstall}
|
bos@85
|
3
|
bos@85
|
4 \section{On a Unix-like system}
|
bos@85
|
5 \label{sec:srcinstall:unixlike}
|
bos@85
|
6
|
bos@85
|
7 If you are using a Unix-like system that has a sufficiently recent
|
bos@85
|
8 version of Python (2.3~or newer) available, it is easy to install
|
bos@85
|
9 Mercurial from source.
|
bos@85
|
10 \begin{enumerate}
|
bos@85
|
11 \item Download a recent source tarball from
|
bos@85
|
12 \url{http://www.selenic.com/mercurial/download}.
|
bos@85
|
13 \item Unpack the tarball:
|
bos@85
|
14 \begin{codesample4}
|
bos@85
|
15 gzip -dc mercurial-\emph{version}.tar.gz | tar xf -
|
bos@85
|
16 \end{codesample4}
|
bos@85
|
17 \item Go into the source directory and run the installer script. This
|
bos@85
|
18 will build Mercurial and install it in your home directory.
|
bos@85
|
19 \begin{codesample4}
|
bos@85
|
20 cd mercurial-\emph{version}
|
bos@85
|
21 python setup.py install --force --home=\$HOME
|
bos@85
|
22 \end{codesample4}
|
bos@85
|
23 \end{enumerate}
|
bos@85
|
24 Once the install finishes, Mercurial will be in the \texttt{bin}
|
bos@85
|
25 subdirectory of your home directory. Don't forget to make sure that
|
bos@85
|
26 this directory is present in your shell's search path.
|
bos@85
|
27
|
bos@85
|
28 You will probably need to set the \envar{PYTHONPATH} environment
|
bos@85
|
29 variable so that the Mercurial executable can find the rest of the
|
bos@85
|
30 Mercurial packages. For example, on my laptop, I have set it to
|
bos@85
|
31 \texttt{/home/bos/lib/python}. The exact path that you will need to
|
bos@85
|
32 use depends on how Python was built for your system, but should be
|
bos@85
|
33 easy to figure out. If you're uncertain, look through the output of
|
bos@85
|
34 the installer script above, and see where the contents of the
|
bos@85
|
35 \texttt{mercurial} directory were installed to.
|
bos@85
|
36
|
bos@85
|
37 \section{On Windows}
|
bos@85
|
38
|
bos@85
|
39 Building and installing Mercurial on Windows requires a variety of
|
bos@85
|
40 tools, a fair amount of technical knowledge, and considerable
|
bos@85
|
41 patience. I very much \emph{do not recommend} this route if you are a
|
bos@85
|
42 ``casual user''. Unless you intend to hack on Mercurial, I strongly
|
bos@85
|
43 suggest that you use a binary package instead.
|
bos@85
|
44
|
bos@85
|
45 If you are intent on building Mercurial from source on Windows, follow
|
bos@85
|
46 the ``hard way'' directions on the Mercurial wiki at
|
bos@85
|
47 \url{http://www.selenic.com/mercurial/wiki/index.cgi/WindowsInstall},
|
bos@85
|
48 and expect the process to involve a lot of fiddly work.
|
bos@85
|
49
|
bos@85
|
50 %%% Local Variables:
|
bos@85
|
51 %%% mode: latex
|
bos@85
|
52 %%% TeX-master: "00book"
|
bos@85
|
53 %%% End:
|