Mercurial > hgbook
comparison en/srcinstall.tex @ 85:b7c69a68b0cc
A little progress on "lightning tour".
author | Bryan O'Sullivan <bos@serpentine.com> |
---|---|
date | Wed, 04 Oct 2006 15:15:54 -0700 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
84:43b9793b4e38 | 85:b7c69a68b0cc |
---|---|
1 \chapter{Installing Mercurial from source} | |
2 \label{chap:srcinstall} | |
3 | |
4 \section{On a Unix-like system} | |
5 \label{sec:srcinstall:unixlike} | |
6 | |
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. | |
27 | |
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. | |
36 | |
37 \section{On Windows} | |
38 | |
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. | |
44 | |
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. | |
49 | |
50 %%% Local Variables: | |
51 %%% mode: latex | |
52 %%% TeX-master: "00book" | |
53 %%% End: |