hgbook

annotate en/appC-srcinstall.xml @ 983:5e1e70fcdfdb

find changesets by author, revision, files, or words in the commit message
Corrected some errors.
- Indentation problems
- Syntax errors (missing </para>,...)
- French mistakes
author Frédéric Bouquet <youshe.jaalon@gmail.com>
date Tue Sep 08 23:42:42 2009 +0200 (2009-09-08)
parents 7e7c47481e4f c838b3975bc6
children
rev   line source
bos@559 1 <!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
bos@85 2
bos@559 3 <appendix id="chap:srcinstall">
bos@572 4 <?dbhtml filename="installing-mercurial-from-source.html"?>
bos@559 5 <title>Installing Mercurial from source</title>
bos@85 6
bos@559 7 <sect1 id="sec:srcinstall:unixlike">
bos@559 8 <title>On a Unix-like system</title>
bos@85 9
bos@584 10 <para id="x_5e0">If you are using a Unix-like system that has a sufficiently
bos@559 11 recent version of Python (2.3 or newer) available, it is easy to
bos@559 12 install Mercurial from source.</para>
bos@559 13 <orderedlist>
bos@584 14 <listitem><para id="x_5e1">Download a recent source tarball from <ulink
bos@559 15 url="http://www.selenic.com/mercurial/download">http://www.selenic.com/mercurial/download</ulink>.</para>
bos@559 16 </listitem>
bos@584 17 <listitem><para id="x_5e2">Unpack the tarball:</para>
bos@559 18 <programlisting>gzip -dc mercurial-MYVERSION.tar.gz | tar xf -</programlisting>
bos@559 19 </listitem>
bos@584 20 <listitem><para id="x_5e3">Go into the source directory and run the
bos@559 21 installer script. This will build Mercurial and install it
bos@559 22 in your home directory.</para>
bos@559 23 <programlisting>cd mercurial-MYVERSION
bos@559 24 python setup.py install --force --home=$HOME</programlisting>
bos@559 25 </listitem>
bos@559 26 </orderedlist>
bos@584 27 <para id="x_5e4">Once the install finishes, Mercurial will be in the
bos@559 28 <literal>bin</literal> subdirectory of your home directory.
bos@559 29 Don't forget to make sure that this directory is present in your
bos@559 30 shell's search path.</para>
bos@85 31
bos@584 32 <para id="x_5e5">You will probably need to set the <envar>PYTHONPATH</envar>
bos@559 33 environment variable so that the Mercurial executable can find
bos@559 34 the rest of the Mercurial packages. For example, on my laptop,
bos@559 35 I have set it to <literal>/home/bos/lib/python</literal>. The
bos@559 36 exact path that you will need to use depends on how Python was
bos@559 37 built for your system, but should be easy to figure out. If
bos@559 38 you're uncertain, look through the output of the installer
bos@559 39 script above, and see where the contents of the
bos@559 40 <literal>mercurial</literal> directory were installed to.</para>
bos@85 41
bos@559 42 </sect1>
bos@559 43 <sect1>
bos@559 44 <title>On Windows</title>
bos@85 45
bos@584 46 <para id="x_5e6">Building and installing Mercurial on Windows requires a
bos@559 47 variety of tools, a fair amount of technical knowledge, and
bos@559 48 considerable patience. I very much <emphasis>do not
bos@559 49 recommend</emphasis> this route if you are a <quote>casual
bos@559 50 user</quote>. Unless you intend to hack on Mercurial, I
bos@559 51 strongly suggest that you use a binary package instead.</para>
bos@85 52
bos@584 53 <para id="x_5e7">If you are intent on building Mercurial from source on
bos@559 54 Windows, follow the <quote>hard way</quote> directions on the
bos@559 55 Mercurial wiki at <ulink
bos@559 56 url="http://www.selenic.com/mercurial/wiki/index.cgi/WindowsInstall">http://www.selenic.com/mercurial/wiki/index.cgi/WindowsInstall</ulink>,
bos@559 57 and expect the process to involve a lot of fiddly work.</para>
bos@559 58
bos@559 59 </sect1>
bos@559 60 </appendix>
bos@559 61
bos@559 62 <!--
bos@559 63 local variables:
bos@559 64 sgml-parent-document: ("00book.xml" "book" "appendix")
bos@559 65 end:
bos@559 66 -->