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