| rev |
line source |
|
bos@84
|
1 \chapter{A lightning tour of Mercurial}
|
|
bos@84
|
2 \label{chap:tour}
|
|
bos@84
|
3
|
|
bos@84
|
4 \section{Installing Mercurial on your system}
|
|
bos@84
|
5 \label{sec:tour:install}
|
|
bos@84
|
6
|
|
bos@85
|
7 Prebuilt binary packages of Mercurial are available for every popular
|
|
bos@85
|
8 operating system. These make it easy to start using Mercurial on your
|
|
bos@85
|
9 computer immediately.
|
|
bos@85
|
10
|
|
bos@84
|
11 \subsection{Linux}
|
|
bos@84
|
12
|
|
bos@84
|
13 Because each Linux distribution has its own packaging tools, policies,
|
|
bos@84
|
14 and rate of development, it's difficult to give a comprehensive set of
|
|
bos@85
|
15 instructions on how to install Mercurial binaries. The version of
|
|
bos@85
|
16 Mercurial that you will end up with can vary depending on how active
|
|
bos@85
|
17 the person is who maintains the package for your distribution.
|
|
bos@84
|
18
|
|
bos@84
|
19 To keep things simple, I will focus on installing Mercurial from the
|
|
bos@84
|
20 command line under the most popular Linux distributions. Most of
|
|
bos@84
|
21 these distributions provide graphical package managers that will let
|
|
bos@84
|
22 you install Mercurial with a single click; the package name to look
|
|
bos@84
|
23 for is \texttt{mercurial}.
|
|
bos@84
|
24
|
|
bos@85
|
25 \begin{itemize}
|
|
bos@85
|
26 \item[Debian]
|
|
bos@85
|
27 \begin{codesample4}
|
|
bos@85
|
28 apt-get install mercurial
|
|
bos@85
|
29 \end{codesample4}
|
|
bos@84
|
30
|
|
bos@85
|
31 \item[Fedora Core]
|
|
bos@85
|
32 \begin{codesample4}
|
|
bos@85
|
33 yum install mercurial
|
|
bos@85
|
34 \end{codesample4}
|
|
bos@84
|
35
|
|
bos@85
|
36 \item[Gentoo]
|
|
bos@85
|
37 \begin{codesample4}
|
|
bos@85
|
38 emerge mercurial
|
|
bos@85
|
39 \end{codesample4}
|
|
bos@84
|
40
|
|
bos@85
|
41 \item[OpenSUSE]
|
|
bos@85
|
42 \begin{codesample4}
|
|
bos@85
|
43 yum install mercurial
|
|
bos@85
|
44 \end{codesample4}
|
|
bos@84
|
45
|
|
bos@85
|
46 \item[Ubuntu] Ubuntu's Mercurial package is particularly old, and you
|
|
bos@85
|
47 should not use it. If you know how, you can rebuild and install the
|
|
bos@85
|
48 Debian package. It's probably easier to build Mercurial from source
|
|
bos@85
|
49 and simply run that; see section~\ref{sec:srcinstall:unixlike} for
|
|
bos@85
|
50 details.
|
|
bos@85
|
51 \end{itemize}
|
|
bos@84
|
52
|
|
bos@84
|
53 \subsection{Mac OS X}
|
|
bos@84
|
54
|
|
bos@84
|
55 Lee Cantey publishes an installer of Mercurial for Mac OS~X at
|
|
bos@84
|
56 \url{http://mercurial.berkwood.com}. This package works on both
|
|
bos@85
|
57 Intel-~and Power-based Macs. Before you can use it, you must install
|
|
bos@85
|
58 a compatible version of Universal MacPython~\cite{web:macpython}. This
|
|
bos@85
|
59 is easy to do; simply follow the instructions on Lee's site.
|
|
bos@84
|
60
|
|
bos@84
|
61 \subsection{Solaris}
|
|
bos@84
|
62
|
|
bos@84
|
63 XXX.
|
|
bos@84
|
64
|
|
bos@84
|
65 \subsection{Windows}
|
|
bos@84
|
66
|
|
bos@84
|
67 Lee Cantey publishes an installer of Mercurial for Windows at
|
|
bos@84
|
68 \url{http://mercurial.berkwood.com}. This package has no external
|
|
bos@84
|
69 dependencies; it ``just works''.
|
|
bos@84
|
70
|
|
bos@84
|
71 \begin{note}
|
|
bos@84
|
72 The Windows version of Mercurial does not automatically convert line
|
|
bos@84
|
73 endings between Windows and Unix styles. If you want to share work
|
|
bos@84
|
74 with Unix users, you must do a little additional configuration
|
|
bos@84
|
75 work. XXX Flesh this out.
|
|
bos@84
|
76 \end{note}
|
|
bos@84
|
77
|
|
bos@85
|
78
|
|
bos@84
|
79 %%% Local Variables:
|
|
bos@84
|
80 %%% mode: latex
|
|
bos@84
|
81 %%% TeX-master: "00book"
|
|
bos@84
|
82 %%% End:
|
