hgbook
changeset 1114:527b86d55d4a tip
inotify: update installation information
inotify is shipped in Mercurial since 1.0, which greatly simplifies the installation process
inotify is shipped in Mercurial since 1.0, which greatly simplifies the installation process
author | Nicolas Dumazet <nicdumz.commits@gmail.com> |
---|---|
date | Sun Dec 13 16:35:56 2009 +0900 (2009-12-13) |
parents | 613690ad6a9c |
children | |
files | en/ch14-hgext.xml |
line diff
1.1 --- a/en/ch14-hgext.xml Sat Jul 10 16:21:26 2010 +0100 1.2 +++ b/en/ch14-hgext.xml Sun Dec 13 16:35:56 2009 +0900 1.3 @@ -139,75 +139,8 @@ 1.4 </listitem></itemizedlist> 1.5 1.6 <para id="x_510">The <literal role="hg-ext">inotify</literal> extension is 1.7 - not yet shipped with Mercurial as of May 2007, so it's a little 1.8 - more involved to set up than other extensions. But the 1.9 - performance improvement is worth it!</para> 1.10 - 1.11 - <para id="x_511">The extension currently comes in two parts: a set of patches 1.12 - to the Mercurial source code, and a library of Python bindings 1.13 - to the <literal>inotify</literal> subsystem.</para> 1.14 - <note> 1.15 - <para id="x_512"> There are <emphasis>two</emphasis> Python 1.16 - <literal>inotify</literal> binding libraries. One of them is 1.17 - called <literal>pyinotify</literal>, and is packaged by some 1.18 - Linux distributions as <literal>python-inotify</literal>. 1.19 - This is <emphasis>not</emphasis> the one you'll need, as it is 1.20 - too buggy and inefficient to be practical.</para> 1.21 - </note> 1.22 - <para id="x_513">To get going, it's best to already have a functioning copy 1.23 - of Mercurial installed.</para> 1.24 - <note> 1.25 - <para id="x_514"> If you follow the instructions below, you'll be 1.26 - <emphasis>replacing</emphasis> and overwriting any existing 1.27 - installation of Mercurial that you might already have, using 1.28 - the latest <quote>bleeding edge</quote> Mercurial code. Don't 1.29 - say you weren't warned!</para> 1.30 - </note> 1.31 - <orderedlist> 1.32 - <listitem><para id="x_515">Clone the Python <literal>inotify</literal> 1.33 - binding repository. Build and install it.</para> 1.34 - <programlisting>hg clone http://hg.kublai.com/python/inotify 1.35 -cd inotify 1.36 -python setup.py build --force 1.37 -sudo python setup.py install --skip-build</programlisting> 1.38 - </listitem> 1.39 - <listitem><para id="x_516">Clone the <filename 1.40 - class="directory">crew</filename> Mercurial repository. 1.41 - Clone the <literal role="hg-ext">inotify</literal> patch 1.42 - repository so that Mercurial Queues will be able to apply 1.43 - patches to your cope of the <filename 1.44 - class="directory">crew</filename> repository.</para> 1.45 - <programlisting>hg clone http://hg.intevation.org/mercurial/crew 1.46 -hg clone crew inotify 1.47 -hg clone http://hg.kublai.com/mercurial/patches/inotify inotify/.hg/patches</programlisting> 1.48 - </listitem> 1.49 - <listitem><para id="x_517">Make sure that you have the Mercurial Queues 1.50 - extension, <literal role="hg-ext">mq</literal>, enabled. If 1.51 - you've never used MQ, read <xref 1.52 - linkend="sec:mq:start"/> to get started 1.53 - quickly.</para> 1.54 - </listitem> 1.55 - <listitem><para id="x_518">Go into the <filename 1.56 - class="directory">inotify</filename> repo, and apply all 1.57 - of the <literal role="hg-ext">inotify</literal> patches 1.58 - using the <option role="hg-ext-mq-cmd-qpush-opt">hg 1.59 - -a</option> option to the <command 1.60 - role="hg-ext-mq">qpush</command> command.</para> 1.61 - <programlisting>cd inotify 1.62 -hg qpush -a</programlisting> 1.63 - </listitem> 1.64 - <listitem><para id="x_519"> If you get an error message from <command 1.65 - role="hg-ext-mq">qpush</command>, you should not continue. 1.66 - Instead, ask for help.</para> 1.67 - </listitem> 1.68 - <listitem><para id="x_51a">Build and install the patched version of 1.69 - Mercurial.</para> 1.70 - <programlisting>python setup.py build --force 1.71 -sudo python setup.py install --skip-build</programlisting> 1.72 - </listitem> 1.73 - </orderedlist> 1.74 - <para id="x_51b">Once you've build a suitably patched version of Mercurial, 1.75 - all you need to do to enable the <literal 1.76 + shipped with Mercurial since 1.0. 1.77 + All you need to do to enable the <literal 1.78 role="hg-ext">inotify</literal> extension is add an entry to 1.79 your <filename role="special">~/.hgrc</filename>.</para> 1.80 <programlisting>[extensions] inotify =</programlisting>