annotate ja/srcinstall.tex @ 835:8a3041e6f3cb

reflect comments by Hiroshi Someya.
author Yoshiki Yazawa <yaz@honeyplanet.jp>
date Sat, 11 Jul 2009 19:25:35 +0900
parents 57fb4684b8e3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
1 %\chapter{Installing Mercurial from source}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
2 \chapter{$B%=!<%9$+$i(BMercurial$B$r%$%s%9%H!<%k$9$k(B}
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
3 \label{chap:srcinstall}
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
4
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
5 %\section{On a Unix-like system}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
6 \section{Unix$B7O%7%9%F%`$G$N%$%s%9%H!<%k(B}
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
7 \label{sec:srcinstall:unixlike}
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
8
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
9 %If you are using a Unix-like system that has a sufficiently recent
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
10 %version of Python (2.3~or newer) available, it is easy to install
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
11 %Mercurial from source.
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
12 %\begin{enumerate}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
13 %\item Download a recent source tarball from
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
14 % \url{http://www.selenic.com/mercurial/download}.
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
15 %\item Unpack the tarball:
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
16 % \begin{codesample4}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
17 % gzip -dc mercurial-\emph{version}.tar.gz | tar xf -
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
18 % \end{codesample4}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
19 %\item Go into the source directory and run the installer script. This
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
20 % will build Mercurial and install it in your home directory.
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
21 % \begin{codesample4}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
22 % cd mercurial-\emph{version}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
23 % python setup.py install --force --home=\$HOME
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
24 % \end{codesample4}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
25 %\end{enumerate}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
26 %Once the install finishes, Mercurial will be in the \texttt{bin}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
27 %subdirectory of your home directory. Don't forget to make sure that
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
28 %this directory is present in your shell's search path.
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
29
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
30 Python (2.3~$B0\9T(B)$B$N%$%s%9%H!<%k$5$l$F$$$k!$==J,?7$7$$(BUnix$B7O$N%7%9%F%`$G(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
31 $B$O!$(BMercurial$B$N%=!<%9$+$i$N%$%s%9%H!<%k$O4JC1$G$"$k!%(B
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
32 \begin{enumerate}
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
33 \item \url{http://www.selenic.com/mercurial/download}$B$+$i?7$7$$%=!<%9$N(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
34 tarball$B$r%@%&%s%m!<%I$9$k(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
35 \item tarball$B$r2rE`$9$k(B:
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
36 \begin{codesample4}
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
37 gzip -dc mercurial-\emph{version}.tar.gz | tar xf -
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
38 \end{codesample4}
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
39 \item $B%=!<%9%G%#%l%/%H%j$KF~$C$F!$%$%s%9%H!<%i%9%/%j%W%H$r<B9T$9$k!%(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
40 Mercurial$B$,%S%k%I$5$l!$%f!<%6%[!<%`%G%#%l%/%H%j$K%$%s%9%H!<%k$5$l(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
41 $B$k!%(B
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
42 \begin{codesample4}
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
43 cd mercurial-\emph{version}
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
44 python setup.py install --force --home=\$HOME
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
45 \end{codesample4}
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
46 \end{enumerate}
835
8a3041e6f3cb reflect comments by Hiroshi Someya.
Yoshiki Yazawa <yaz@honeyplanet.jp>
parents: 336
diff changeset
47 $B%$%s%9%H!<%k$r9T$&$H!$(BMercurial$B$O%f!<%6%[!<%`%G%#%l%/%H%jFb$N(B
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
48 \texttt{bin}$B%5%V%G%#%l%/%H%j$K<}$a$i$l$k!%$3$N%G%#%l%/%H%j$,%7%'%k$N%3%^(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
49 $B%s%I%5!<%A%Q%9$K$"$k$N$r3NG'$9$k$3$H!%(B
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
50
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
51 %You will probably need to set the \envar{PYTHONPATH} environment
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
52 %variable so that the Mercurial executable can find the rest of the
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
53 %Mercurial packages. For example, on my laptop, I have set it to
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
54 %\texttt{/home/bos/lib/python}. The exact path that you will need to
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
55 %use depends on how Python was built for your system, but should be
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
56 %easy to figure out. If you're uncertain, look through the output of
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
57 %the installer script above, and see where the contents of the
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
58 %\texttt{mercurial} directory were installed to.
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
59
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
60 Mercurial$B$N<B9T%U%!%$%k$,B>$N(BMercurial$B%Q%C%1!<%8$rH/8+$G$-$k$h$&$K!$$*$=(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
61 $B$i$/4D6-JQ?t(B\envar{PYTHONPATH}$B$r@_Dj$9$k$3$H$,I,MW$K$J$k!%Nc$($P!$I.<T$N(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
62 $B%i%C%W%H%C%W$G$O$3$l$r(B\texttt{/home/bos/lib/python}$B$K@_Dj$7$F$$$k!%(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
63 $B<B:]$N@5$7$$%Q%9$O$I$N$h$&$K(BPython$B$r%S%k%I$7$?$+$K$h$k$,!$$3$l$r8+$D$1=P(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
64 $B$9$N$O4JC1$JH&$@!%$b$7ITL@$G$"$l$P!$A0=R$N%$%s%9%H!<%i%9%/%j%W%H$N=PNO$+(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
65 $B$i!$(B\texttt{mercurial}$B%G%#%l%/%H%j$NCf?H$,$I$3$K%$%s%9%H!<%k$5$l$?$+$r8+(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
66 $B$l$PNI$$!%(B
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
67
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
68 %\section{On Windows}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
69 \section{Windows$B$G$N%$%s%9%H!<%k(B}
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
70
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
71 %Building and installing Mercurial on Windows requires a variety of
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
72 %tools, a fair amount of technical knowledge, and considerable
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
73 %patience. I very much \emph{do not recommend} this route if you are a
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
74 %``casual user''. Unless you intend to hack on Mercurial, I strongly
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
75 %suggest that you use a binary package instead.
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
76
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
77 Mercurial$B$r(BWindows$B>e$G%=!<%9$+$i%S%k%I$7%$%s%9%H!<%k$9$k$?$a$K$O!$B?$/$N(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
78 $B%D!<%k$,I,MW$G!$$=$l$J$j$N5;=QE*CN<1$,I,MW$G$"$j!$:$Fq$G$"$k!%$b$7%+%8%e(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
79 $B%"%k$J%f!<%6$G$"$l$P!$$3$N$d$jJ}$O$*$9$9$a$7$J$$!%(BMercurial$B<+BN$r%O%C%/$7(B
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
80 $B$?$$$N$G$J$1$l$P!$%P%$%J%j%Q%C%1!<%8$r$*$9$9$a$9$k!%(B
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
81
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
82 %If you are intent on building Mercurial from source on Windows, follow
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
83 %the ``hard way'' directions on the Mercurial wiki at
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
84 %\url{http://www.selenic.com/mercurial/wiki/index.cgi/WindowsInstall},
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
85 %and expect the process to involve a lot of fiddly work.
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
86
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
87 $B$b$7(BMercurial$B$r(BWindows$B>e$G%=!<%9$+$i%S%k%I$7$?$$$N$G$"$l$P!$(BMercurial
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
88 wiki
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
89 \url{http://www.selenic.com/mercurial/wiki/index.cgi/WindowsInstall} $B$N(B
835
8a3041e6f3cb reflect comments by Hiroshi Someya.
Yoshiki Yazawa <yaz@honeyplanet.jp>
parents: 336
diff changeset
90 ``hard way''$B$N@bL@$K=>$C$F9T$&!%$3$NJ}K!$G$OB?$/$NLLE]$J:n6H$,BT$A9=$((B
336
57fb4684b8e3 done srcinstall.tex
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 293
diff changeset
91 $B$F$$$k$3$H$r3P8g$9$kI,MW$,$"$k!%(B
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
92
835
8a3041e6f3cb reflect comments by Hiroshi Someya.
Yoshiki Yazawa <yaz@honeyplanet.jp>
parents: 336
diff changeset
93 %%% Local Variables:
293
3b1291f24c0d - replaved latex-mode to yatex-mode
Yoshiki Yazawa <yaz@cc.rim.or.jp>
parents: 290
diff changeset
94 %%% mode: yatex
85
b7c69a68b0cc A little progress on "lightning tour".
Bryan O'Sullivan <bos@serpentine.com>
parents:
diff changeset
95 %%% TeX-master: "00book"
835
8a3041e6f3cb reflect comments by Hiroshi Someya.
Yoshiki Yazawa <yaz@honeyplanet.jp>
parents: 336
diff changeset
96 %%% End: