hgbook

changeset 1114:527b86d55d4a tip

inotify: update installation information

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>