SEES-hacks: SEESenv/web/html/backup/abc.html@514098969b11 (annotated)

0 8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	1	<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	2	<title>Chapter 9. Finding and fixing mistakes</title>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	3	<link rel="stylesheet" href="/support/styles.css" type="text/css">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	4	<meta name="generator" content="DocBook XSL Stylesheets V1.74.3"><link rel="home" href="index.html" title="Mercurial: The Definitive Guide">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	5	<link rel="up" href="index.html" title="Mercurial: The Definitive Guide">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	6	<link rel="prev" href="managing-releases-and-branchy-development.html" title="Chapter 8. Managing releases and branchy development">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	7	<link rel="next" href="handling-repository-events-with-hooks.html" title="Chapter 10. Handling repository events with hooks"><link rel="alternate" type="application/atom+xml" title="Comments" href="/feeds/comments/">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	8	<link rel="shortcut icon" type="image/png" href="/support/figs/favicon.png">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	9	<script type="text/javascript" src="/support/jquery-min.js"></script>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	10	<script type="text/javascript" src="/support/form.js"></script>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	11	<script type="text/javascript" src="/support/hsbook.js"></script></head>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	12	<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	13	<div class="navheader">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	14	<table width="100%" summary="Navigation header">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	15	<tr><th colspan="3" align="center">Chapter 14. Adding functionality with extensions</th></tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	16	<tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	17	<td width="20%" align="left">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	18	<a accesskey="p" href="advanced-uses-of-mercurial-queues.html">Prev</a> </td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	19	<th width="60%" align="center"> </th>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	20	<td width="20%" align="right"> <a accesskey="n" href="migrating-to-mercurial.html">Next</a>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	21	</td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	22	</tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	23	</table>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	24	<hr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	25	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	26	<div class="chapter" title="Chapter 14. Adding functionality with extensions">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	27	<div class="titlepage"><div><div><h2 class="title">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	28	<a name="chap:hgext"></a>Chapter 14. Adding functionality with extensions</h2></div></div></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	29	<div class="toc">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	30	<p><b>Table of Contents</b></p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	31	<dl>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	32	<dt><span class="sect1"><a href="adding-functionality-with-extensions.html#sec:hgext:inotify">14.1. Improve performance with the <code class="literal">inotify</code> extension</a></span></dt>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	33	<dt><span class="sect1"><a href="adding-functionality-with-extensions.html#sec:hgext:extdiff">14.2. Flexible diff support with the <code class="literal">extdiff</code> extension</a></span></dt>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	34	<dd><dl><dt><span class="sect2"><a href="adding-functionality-with-extensions.html#id3071699">14.2.1. Defining command aliases</a></span></dt></dl></dd>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	35	<dt><span class="sect1"><a href="adding-functionality-with-extensions.html#sec:hgext:transplant">14.3. Cherrypicking changes with the <code class="literal">transplant</code> extension</a></span></dt>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	36	<dt><span class="sect1"><a href="adding-functionality-with-extensions.html#sec:hgext:patchbomb">14.4. Send changes via email with the <code class="literal">patchbomb</code> extension</a></span></dt>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	37	<dd><dl><dt><span class="sect2"><a href="adding-functionality-with-extensions.html#id3072184">14.4.1. Changing the behavior of patchbombs</a></span></dt></dl></dd>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	38	</dl>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	39	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	40	<p id="x_4fe"></a>While the core of Mercurial is quite complete from a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	41	functionality standpoint, it's deliberately shorn of fancy
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	42	features. This approach of preserving simplicity keeps the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	43	software easy to deal with for both maintainers and users.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	44	<p id="x_4ff"></a>However, Mercurial doesn't box you in with an inflexible
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	45	command set: you can add features to it as
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	46	<span class="emphasis"><em>extensions</em></span> (sometimes known as
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	47	<span class="emphasis"><em>plugins</em></span>). We've already discussed a few of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	48	these extensions in earlier chapters.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	49	<p id="x_546" id="x_546"></a>When you provide a directory name, Mercurial will interpret
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	50	this as “<span class="quote">operate on every file in this directory and its
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	51	subdirectories</span>”. Mercurial traverses the files and
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	52	subdirectories in a directory in alphabetical order. When it
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	53	encounters a subdirectory, it will traverse that subdirectory
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	54	before continuing with the current directory.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	55
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	56
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	57
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	58	<div class="itemizedlist"><ul class="itemizedlist" type="disc">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	59	<li class="listitem"><p id="x_500"></a><a class="xref" href="a-tour-of-mercurial-merging-work.html#sec:tour-merge:fetch" title="3.3. Simplifying the pull-merge-commit sequence">Section 3.3, “Simplifying the pull-merge-commit sequence”</a>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	60	covers the <code class="literal">fetch</code> extension;
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	61	this combines pulling new changes and merging them with local
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	62	changes into a single command, <span class="command"><strong>fetch</strong></span>.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	63	<li class="listitem"><p id="x_501"></a>In <a class="xref" href="handling-repository-events-with-hooks.html" title="Chapter 10. Handling repository events with hooks">Chapter 10, <i>Handling repository events with hooks</i></a>, we covered
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	64	several extensions that are useful for hook-related
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	65	functionality: <code class="literal">acl</code> adds
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	66	access control lists; <code class="literal">bugzilla</code> adds integration with the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	67	Bugzilla bug tracking system; and <code class="literal">notify</code> sends notification emails on
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	68	new changes.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	69	<li class="listitem"><p id="x_502"></a>The Mercurial Queues patch management extension is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	70	so invaluable that it merits two chapters and an appendix all
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	71	to itself. <a class="xref" href="managing-change-with-mercurial-queues.html" title="Chapter 12. Managing change with Mercurial Queues">Chapter 12, <i>Managing change with Mercurial Queues</i></a> covers the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	72	basics; <a class="xref" href="advanced-uses-of-mercurial-queues.html" title="Chapter 13. Advanced uses of Mercurial Queues">Chapter 13, <i>Advanced uses of Mercurial Queues</i></a> discusses advanced topics;
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	73	and <a class="xref" href="mercurial-queues-reference.html" title="Appendix B. Mercurial Queues reference">Appendix B, <i>Mercurial Queues reference</i></a> goes into detail on
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	74	each
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	75	command.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	76	</ul></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	77	<p id="x_503"></a>In this chapter, we'll cover some of the other extensions that
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	78	are available for Mercurial, and briefly touch on some of the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	79	machinery you'll need to know about if you want to write an
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	80	extension of your own.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	81	<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p id="x_504"></a>In <a class="xref" href="adding-functionality-with-extensions.html#sec:hgext:inotify" title="14.1. Improve performance with the inotify extension">Section 14.1, “Improve performance with the <code class="literal">inotify</code> extension”</a>,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	82	we'll discuss the possibility of <span class="emphasis"><em>huge</em></span>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	83	performance improvements using the <code class="literal">inotify</code> extension.</p></li></ul></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	84	<div class="sect1" title="14.1. Improve performance with the inotify extension">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	85	<div class="titlepage"><div><div><h2 class="title" style="clear: both">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	86	<a name="sec:hgext:inotify"></a>14.1. Improve performance with the <code class="literal">inotify</code> extension</h2></div></div></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	87	<p id="x_505"></a>Are you interested in having some of the most common
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	88	Mercurial operations run as much as a hundred times faster?
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	89	Read on!</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	90	<p id="x_506"></a>Mercurial has great performance under normal circumstances.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	91	For example, when you run the <span class="command"><strong>hg
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	92	status</strong></span> command, Mercurial has to scan almost every
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	93	directory and file in your repository so that it can display
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	94	file status. Many other Mercurial commands need to do the same
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	95	work behind the scenes; for example, the <span class="command"><strong>hg diff</strong></span> command uses the status
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	96	machinery to avoid doing an expensive comparison operation on
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	97	files that obviously haven't changed.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	98	<p id="x_507"></a>Because obtaining file status is crucial to good
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	99	performance, the authors of Mercurial have optimised this code
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	100	to within an inch of its life. However, there's no avoiding the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	101	fact that when you run <span class="command"><strong>hg
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	102	status</strong></span>, Mercurial is going to have to perform at
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	103	least one expensive system call for each managed file to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	104	determine whether it's changed since the last time Mercurial
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	105	checked. For a sufficiently large repository, this can take a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	106	long time.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	107	<p id="x_508"></a>To put a number on the magnitude of this effect, I created a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	108	repository containing 150,000 managed files. I timed <span class="command"><strong>hg status</strong></span> as taking ten seconds to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	109	run, even when <span class="emphasis"><em>none</em></span> of those files had been
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	110	modified.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	111	<p id="x_509"></a>Many modern operating systems contain a file notification
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	112	facility. If a program signs up to an appropriate service, the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	113	operating system will notify it every time a file of interest is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	114	created, modified, or deleted. On Linux systems, the kernel
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	115	component that does this is called
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	116	<code class="literal">inotify</code>.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	117	<p id="x_50a"></a>Mercurial's <code class="literal">inotify</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	118	extension talks to the kernel's <code class="literal">inotify</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	119	component to optimise <span class="command"><strong>hg status</strong></span>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	120	commands. The extension has two components. A daemon sits in
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	121	the background and receives notifications from the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	122	<code class="literal">inotify</code> subsystem. It also listens for
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	123	connections from a regular Mercurial command. The extension
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	124	modifies Mercurial's behavior so that instead of scanning the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	125	filesystem, it queries the daemon. Since the daemon has perfect
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	126	information about the state of the repository, it can respond
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	127	with a result instantaneously, avoiding the need to scan every
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	128	directory and file in the repository.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	129	<p id="x_50b"></a>Recall the ten seconds that I measured plain Mercurial as
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	130	taking to run <span class="command"><strong>hg status</strong></span> on a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	131	150,000 file repository. With the <code class="literal">inotify</code> extension enabled, the time
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	132	dropped to 0.1 seconds, a factor of <span class="emphasis"><em>one
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	133	hundred</em></span> faster.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	134	<p id="x_50c"></a>Before we continue, please pay attention to some
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	135	caveats.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	136	<div class="itemizedlist"><ul class="itemizedlist" type="disc">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	137	<li class="listitem"><p id="x_50d"></a>The <code class="literal">inotify</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	138	extension is Linux-specific. Because it interfaces directly
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	139	to the Linux kernel's <code class="literal">inotify</code> subsystem,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	140	it does not work on other operating systems.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	141	<li class="listitem"><p id="x_50e"></a>It should work on any Linux distribution that
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	142	was released after early 2005. Older distributions are
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	143	likely to have a kernel that lacks
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	144	<code class="literal">inotify</code>, or a version of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	145	<code class="literal">glibc</code> that does not have the necessary
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	146	interfacing support.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	147	<li class="listitem"><p id="x_50f"></a>Not all filesystems are suitable for use with
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	148	the <code class="literal">inotify</code> extension.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	149	Network filesystems such as NFS are a non-starter, for
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	150	example, particularly if you're running Mercurial on several
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	151	systems, all mounting the same network filesystem. The
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	152	kernel's <code class="literal">inotify</code> system has no way of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	153	knowing about changes made on another system. Most local
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	154	filesystems (e.g. ext3, XFS, ReiserFS) should work
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	155	fine.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	156	</ul></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	157	<p id="x_510"></a>The <code class="literal">inotify</code> extension is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	158	not yet shipped with Mercurial as of May 2007, so it's a little
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	159	more involved to set up than other extensions. But the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	160	performance improvement is worth it!</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	161	<p id="x_511"></a>The extension currently comes in two parts: a set of patches
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	162	to the Mercurial source code, and a library of Python bindings
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	163	to the <code class="literal">inotify</code> subsystem.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	164	<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	165	<tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	166	<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="figs/note.png"></td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	167	<th align="left">Note</th>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	168	</tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	169	<tr><td align="left" valign="top"><p id="x_512"></a> There are <span class="emphasis"><em>two</em></span> Python
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	170	<code class="literal">inotify</code> binding libraries. One of them is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	171	called <code class="literal">pyinotify</code>, and is packaged by some
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	172	Linux distributions as <code class="literal">python-inotify</code>.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	173	This is <span class="emphasis"><em>not</em></span> the one you'll need, as it is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	174	too buggy and inefficient to be practical.</p></td></tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	175	</table></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	176	<p id="x_513"></a>To get going, it's best to already have a functioning copy
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	177	of Mercurial installed.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	178	<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	179	<tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	180	<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="figs/note.png"></td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	181	<th align="left">Note</th>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	182	</tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	183	<tr><td align="left" valign="top"><p id="x_514"></a> If you follow the instructions below, you'll be
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	184	<span class="emphasis"><em>replacing</em></span> and overwriting any existing
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	185	installation of Mercurial that you might already have, using
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	186	the latest <span class="quote">“<span class="quote">bleeding edge</span>”</span> Mercurial code. Don't
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	187	say you weren't warned!</p></td></tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	188	</table></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	189	<div class="orderedlist"><ol class="orderedlist" type="1">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	190	<li class="listitem">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	191	<p id="x_515"></a>Clone the Python <code class="literal">inotify</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	192	binding repository. Build and install it.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	193	<pre class="programlisting">hg clone http://hg.kublai.com/python/inotify
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	194	cd inotify
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	195	python setup.py build --force
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	196	sudo python setup.py install --skip-build</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	197	</li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	198	<li class="listitem">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	199	<p id="x_516"></a>Clone the <code class="filename">crew</code> Mercurial repository.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	200	Clone the <code class="literal">inotify</code> patch
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	201	repository so that Mercurial Queues will be able to apply
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	202	patches to your cope of the <code class="filename">crew</code> repository.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	203	<pre class="programlisting">hg clone http://hg.intevation.org/mercurial/crew
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	204	hg clone crew inotify
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	205	hg clone http://hg.kublai.com/mercurial/patches/inotify inotify/.hg/patches</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	206	</li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	207	<li class="listitem"><p id="x_517"></a>Make sure that you have the Mercurial Queues
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	208	extension, <code class="literal">mq</code>, enabled. If
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	209	you've never used MQ, read <a class="xref" href="managing-change-with-mercurial-queues.html#sec:mq:start" title="12.5. Getting started with Mercurial Queues">Section 12.5, “Getting started with Mercurial Queues”</a> to get started
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	210	quickly.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	211	<li class="listitem">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	212	<p id="x_518"></a>Go into the <code class="filename">inotify</code> repo, and apply all
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	213	of the <code class="literal">inotify</code> patches
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	214	using the <code class="option">hg
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	215	-a</code> option to the <span class="command"><strong>qpush</strong></span> command.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	216	<pre class="programlisting">cd inotify
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	217	hg qpush -a</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	218	</li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	219	<li class="listitem"><p id="x_519"></a> If you get an error message from <span class="command"><strong>qpush</strong></span>, you should not continue.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	220	Instead, ask for help.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	221	<li class="listitem">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	222	<p id="x_51a"></a>Build and install the patched version of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	223	Mercurial.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	224	<pre class="programlisting">python setup.py build --force
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	225	sudo python setup.py install --skip-build</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	226	</li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	227	</ol></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	228	<p id="x_51b"></a>Once you've build a suitably patched version of Mercurial,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	229	all you need to do to enable the <code class="literal">inotify</code> extension is add an entry to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	230	your <code class="filename">~/.hgrc</code>.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	231	<pre class="programlisting">[extensions] inotify =</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	232	<p id="x_51c"></a>When the <code class="literal">inotify</code> extension
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	233	is enabled, Mercurial will automatically and transparently start
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	234	the status daemon the first time you run a command that needs
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	235	status in a repository. It runs one status daemon per
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	236	repository.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	237	<p id="x_51d"></a>The status daemon is started silently, and runs in the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	238	background. If you look at a list of running processes after
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	239	you've enabled the <code class="literal">inotify</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	240	extension and run a few commands in different repositories,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	241	you'll thus see a few <code class="literal">hg</code> processes sitting
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	242	around, waiting for updates from the kernel and queries from
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	243	Mercurial.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	244	<p id="x_51e"></a>The first time you run a Mercurial command in a repository
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	245	when you have the <code class="literal">inotify</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	246	extension enabled, it will run with about the same performance
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	247	as a normal Mercurial command. This is because the status
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	248	daemon needs to perform a normal status scan so that it has a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	249	baseline against which to apply later updates from the kernel.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	250	However, <span class="emphasis"><em>every</em></span> subsequent command that does
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	251	any kind of status check should be noticeably faster on
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	252	repositories of even fairly modest size. Better yet, the bigger
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	253	your repository is, the greater a performance advantage you'll
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	254	see. The <code class="literal">inotify</code> daemon makes
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	255	status operations almost instantaneous on repositories of all
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	256	sizes!</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	257	<p id="x_51f"></a>If you like, you can manually start a status daemon using
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	258	the <span class="command"><strong>inserve</strong></span> command.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	259	This gives you slightly finer control over how the daemon ought
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	260	to run. This command will of course only be available when the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	261	<code class="literal">inotify</code> extension is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	262	enabled.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	263	<p id="x_520"></a>When you're using the <code class="literal">inotify</code> extension, you should notice
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	264	<span class="emphasis"><em>no difference at all</em></span> in Mercurial's
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	265	behavior, with the sole exception of status-related commands
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	266	running a whole lot faster than they used to. You should
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	267	specifically expect that commands will not print different
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	268	output; neither should they give different results. If either of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	269	these situations occurs, please report a bug.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	270	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	271	<div class="sect1" title="14.2. Flexible diff support with the extdiff extension">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	272	<div class="titlepage"><div><div><h2 class="title" style="clear: both">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	273	<a name="sec:hgext:extdiff"></a>14.2. Flexible diff support with the <code class="literal">extdiff</code> extension</h2></div></div></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	274	<p id="x_521"></a>Mercurial's built-in <span class="command"><strong>hg
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	275	diff</strong></span> command outputs plaintext unified diffs.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	276	<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>hg diff</code></strong>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	277	diff -r 80997726a0ea myfile
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	278	--- a/myfile Wed Jan 06 06:50:18 2010 +0000
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	279	+++ b/myfile Wed Jan 06 06:50:18 2010 +0000
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	280	@@ -1,1 +1,2 @@
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	281	The first line.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	282	+The second line.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	283	</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	284	<p id="x_522"></a>If you would like to use an external tool to display
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	285	modifications, you'll want to use the <code class="literal">extdiff</code> extension. This will let you
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	286	use, for example, a graphical diff tool.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	287	<p id="x_523"></a>The <code class="literal">extdiff</code> extension is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	288	bundled with Mercurial, so it's easy to set up. In the <code class="literal">extensions</code> section of your
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	289	<code class="filename">~/.hgrc</code>, simply add a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	290	one-line entry to enable the extension.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	291	<pre class="programlisting">[extensions]
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	292	extdiff =</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	293	<p id="x_524"></a>This introduces a command named <span class="command"><strong>extdiff</strong></span>, which by default uses
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	294	your system's <span class="command"><strong>diff</strong></span> command to generate a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	295	unified diff in the same form as the built-in <span class="command"><strong>hg diff</strong></span> command.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	296	<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>hg extdiff</code></strong>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	297	--- a.80997726a0ea/myfile 2010-01-06 06:50:18.613674526 +0000
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	298	+++ /tmp/extdiffNErQlu/a/myfile 2010-01-06 06:50:18.437687076 +0000
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	299	@@ -1 +1,2 @@
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	300	The first line.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	301	+The second line.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	302	</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	303	<p id="x_525"></a>The result won't be exactly the same as with the built-in
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	304	<span class="command"><strong>hg diff</strong></span> variations, because the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	305	output of <span class="command"><strong>diff</strong></span> varies from one system to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	306	another, even when passed the same options.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	307	<p id="x_526"></a>As the <span class="quote">“<span class="quote"><code class="literal">making snapshot</code></span>”</span>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	308	lines of output above imply, the <span class="command"><strong>extdiff</strong></span> command works by
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	309	creating two snapshots of your source tree. The first snapshot
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	310	is of the source revision; the second, of the target revision or
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	311	working directory. The <span class="command"><strong>extdiff</strong></span> command generates
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	312	these snapshots in a temporary directory, passes the name of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	313	each directory to an external diff viewer, then deletes the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	314	temporary directory. For efficiency, it only snapshots the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	315	directories and files that have changed between the two
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	316	revisions.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	317	<p id="x_527"></a>Snapshot directory names have the same base name as your
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	318	repository. If your repository path is <code class="filename">/quux/bar/foo</code>, then <code class="filename">foo</code> will be the name of each
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	319	snapshot directory. Each snapshot directory name has its
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	320	changeset ID appended, if appropriate. If a snapshot is of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	321	revision <code class="literal">a631aca1083f</code>, the directory will be
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	322	named <code class="filename">foo.a631aca1083f</code>.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	323	A snapshot of the working directory won't have a changeset ID
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	324	appended, so it would just be <code class="filename">foo</code> in this example. To see what
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	325	this looks like in practice, look again at the <span class="command"><strong>extdiff</strong></span> example above. Notice
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	326	that the diff has the snapshot directory names embedded in its
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	327	header.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	328	<p id="x_528"></a>The <span class="command"><strong>extdiff</strong></span> command
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	329	accepts two important options. The <code class="option">hg -p</code> option
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	330	lets you choose a program to view differences with, instead of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	331	<span class="command"><strong>diff</strong></span>. With the <code class="option">hg -o</code> option,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	332	you can change the options that <span class="command"><strong>extdiff</strong></span> passes to the program
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	333	(by default, these options are
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	334	<span class="quote">“<span class="quote"><code class="literal">-Npru</code></span>”</span>, which only make sense
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	335	if you're running <span class="command"><strong>diff</strong></span>). In other respects,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	336	the <span class="command"><strong>extdiff</strong></span> command
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	337	acts similarly to the built-in <span class="command"><strong>hg
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	338	diff</strong></span> command: you use the same option names, syntax,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	339	and arguments to specify the revisions you want, the files you
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	340	want, and so on.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	341	<p id="x_529"></a>As an example, here's how to run the normal system
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	342	<span class="command"><strong>diff</strong></span> command, getting it to generate context
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	343	diffs (using the <code class="option">-c</code> option)
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	344	instead of unified diffs, and five lines of context instead of
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	345	the default three (passing <code class="literal">5</code> as the argument
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	346	to the <code class="option">-C</code> option).</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	347	<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>hg extdiff -o -NprcC5</code></strong>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	348	*** a.80997726a0ea/myfile Wed Jan 6 06:50:18 2010
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	349	--- /tmp/extdiffNErQlu/a/myfile Wed Jan 6 06:50:18 2010
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	350	***************
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	351	* 1 **
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	352	--- 1,2 ----
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	353	The first line.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	354	+ The second line.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	355	</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	356	<p id="x_52a"></a>Launching a visual diff tool is just as easy. Here's how to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	357	launch the <span class="command"><strong>kdiff3</strong></span> viewer.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	358	<pre class="programlisting">hg extdiff -p kdiff3 -o</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	359	<p id="x_52b"></a>If your diff viewing command can't deal with directories,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	360	you can easily work around this with a little scripting. For an
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	361	example of such scripting in action with the <code class="literal">mq</code> extension and the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	362	<span class="command"><strong>interdiff</strong></span> command, see <a class="xref" href="advanced-uses-of-mercurial-queues.html#mq-collab:tips:interdiff" title="13.9.2. Viewing the history of a patch">Section 13.9.2, “Viewing the history of a patch”</a>.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	363	<div class="sect2" title="14.2.1. Defining command aliases">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	364	<div class="titlepage"><div><div><h3 class="title">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	365	<a name="id3071699"></a>14.2.1. Defining command aliases</h3></div></div></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	366	<p id="x_52c"></a>It can be cumbersome to remember the options to both the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	367	<span class="command"><strong>extdiff</strong></span> command and
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	368	the diff viewer you want to use, so the <code class="literal">extdiff</code> extension lets you define
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	369	<span class="emphasis"><em>new</em></span> commands that will invoke your diff
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	370	viewer with exactly the right options.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	371	<p id="x_52d"></a>All you need to do is edit your <code class="filename">~/.hgrc</code>, and add a section named
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	372	<code class="literal">extdiff</code>. Inside this
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	373	section, you can define multiple commands. Here's how to add
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	374	a <code class="literal">kdiff3</code> command. Once you've defined
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	375	this, you can type <span class="quote">“<span class="quote"><code class="literal">hg kdiff3</code></span>”</span>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	376	and the <code class="literal">extdiff</code> extension
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	377	will run <span class="command"><strong>kdiff3</strong></span> for you.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	378	<pre class="programlisting">[extdiff]
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	379	cmd.kdiff3 =</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	380	<p id="x_52e"></a>If you leave the right hand side of the definition empty,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	381	as above, the <code class="literal">extdiff</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	382	extension uses the name of the command you defined as the name
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	383	of the external program to run. But these names don't have to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	384	be the same. Here, we define a command named
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	385	<span class="quote">“<span class="quote"><code class="literal">hg wibble</code></span>”</span>, which runs
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	386	<span class="command"><strong>kdiff3</strong></span>.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	387	<pre class="programlisting">[extdiff]
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	388	cmd.wibble = kdiff3</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	389	<p id="x_52f"></a>You can also specify the default options that you want to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	390	invoke your diff viewing program with. The prefix to use is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	391	<span class="quote">“<span class="quote"><code class="literal">opts.</code></span>”</span>, followed by the name
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	392	of the command to which the options apply. This example
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	393	defines a <span class="quote">“<span class="quote"><code class="literal">hg vimdiff</code></span>”</span> command
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	394	that runs the <span class="command"><strong>vim</strong></span> editor's
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	395	<code class="literal">DirDiff</code> extension.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	396	<pre class="programlisting">[extdiff]
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	397	cmd.vimdiff = vim
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	398	opts.vimdiff = -f '+next' '+execute "DirDiff" argv(0) argv(1)'</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	399	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	400	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	401	<div class="sect1" title="14.3. Cherrypicking changes with the transplant extension">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	402	<div class="titlepage"><div><div><h2 class="title" style="clear: both">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	403	<a name="sec:hgext:transplant"></a>14.3. Cherrypicking changes with the <code class="literal">transplant</code> extension</h2></div></div></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	404	<p id="x_530"></a>Need to have a long chat with Brendan about this.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	405	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	406	<div class="sect1" title="14.4. Send changes via email with the patchbomb extension">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	407	<div class="titlepage"><div><div><h2 class="title" style="clear: both">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	408	<a name="sec:hgext:patchbomb"></a>14.4. Send changes via email with the <code class="literal">patchbomb</code> extension</h2></div></div></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	409	<p id="x_531"></a>Many projects have a culture of <span class="quote">“<span class="quote">change
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	410	review</span>”</span>, in which people send their modifications to a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	411	mailing list for others to read and comment on before they
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	412	commit the final version to a shared repository. Some projects
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	413	have people who act as gatekeepers; they apply changes from
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	414	other people to a repository to which those others don't have
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	415	access.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	416	<p id="x_532"></a>Mercurial makes it easy to send changes over email for
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	417	review or application, via its <code class="literal">patchbomb</code> extension. The extension is
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	418	so named because changes are formatted as patches, and it's usual
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	419	to send one changeset per email message. Sending a long series
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	420	of changes by email is thus much like <span class="quote">“<span class="quote">bombing</span>”</span> the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	421	recipient's inbox, hence <span class="quote">“<span class="quote">patchbomb</span>”</span>.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	422	<p id="x_533"></a>As usual, the basic configuration of the <code class="literal">patchbomb</code> extension takes just one or
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	423	two lines in your <code class="filename">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	424	/.hgrc</code>.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	425	<pre class="programlisting">[extensions]
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	426	patchbomb =</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	427	<p id="x_534"></a>Once you've enabled the extension, you will have a new
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	428	command available, named <span class="command"><strong>email</strong></span>.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	429	<p id="x_535"></a>The safest and best way to invoke the <span class="command"><strong>email</strong></span> command is to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	430	<span class="emphasis"><em>always</em></span> run it first with the <code class="option">hg -n</code> option.
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	431	This will show you what the command <span class="emphasis"><em>would</em></span>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	432	send, without actually sending anything. Once you've had a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	433	quick glance over the changes and verified that you are sending
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	434	the right ones, you can rerun the same command, with the <code class="option">hg -n</code> option
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	435	removed.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	436	<p id="x_536"></a>The <span class="command"><strong>email</strong></span> command
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	437	accepts the same kind of revision syntax as every other
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	438	Mercurial command. For example, this command will send every
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	439	revision between 7 and <code class="literal">tip</code>, inclusive.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	440	<pre class="programlisting">hg email -n 7:tip</pre>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	441	<p id="x_537"></a>You can also specify a <span class="emphasis"><em>repository</em></span> to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	442	compare with. If you provide a repository but no revisions, the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	443	<span class="command"><strong>email</strong></span> command will
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	444	send all revisions in the local repository that are not present
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	445	in the remote repository. If you additionally specify revisions
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	446	or a branch name (the latter using the <code class="option">hg -b</code> option),
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	447	this will constrain the revisions sent.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	448	<p id="x_538"></a>It's perfectly safe to run the <span class="command"><strong>email</strong></span> command without the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	449	names of the people you want to send to: if you do this, it will
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	450	just prompt you for those values interactively. (If you're
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	451	using a Linux or Unix-like system, you should have enhanced
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	452	<code class="literal">readline</code>-style editing capabilities when
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	453	entering those headers, too, which is useful.)</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	454	<p id="x_539"></a>When you are sending just one revision, the <span class="command"><strong>email</strong></span> command will by
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	455	default use the first line of the changeset description as the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	456	subject of the single email message it sends.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	457	<p id="x_53a"></a>If you send multiple revisions, the <span class="command"><strong>email</strong></span> command will usually
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	458	send one message per changeset. It will preface the series with
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	459	an introductory message, in which you should describe the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	460	purpose of the series of changes you're sending.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	461	<div class="sect2" title="14.4.1. Changing the behavior of patchbombs">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	462	<div class="titlepage"><div><div><h3 class="title">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	463	<a name="id3072184"></a>14.4.1. Changing the behavior of patchbombs</h3></div></div></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	464	<p id="x_53b"></a>Not every project has exactly the same conventions for
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	465	sending changes in email; the <code class="literal">patchbomb</code> extension tries to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	466	accommodate a number of variations through command line
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	467	options.</p>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	468	<div class="itemizedlist"><ul class="itemizedlist" type="disc">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	469	<li class="listitem"><p id="x_53c"></a>You can write a subject for the introductory
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	470	message on the command line using the <code class="option">hg -s</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	471	option. This takes one argument, the text of the subject
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	472	to use.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	473	<li class="listitem"><p id="x_53d"></a>To change the email address from which the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	474	messages originate, use the <code class="option">hg -f</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	475	option. This takes one argument, the email address to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	476	use.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	477	<li class="listitem"><p id="x_53e"></a>The default behavior is to send unified diffs
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	478	(see <a class="xref" href="managing-change-with-mercurial-queues.html#sec:mq:patch" title="12.4. Understanding patches">Section 12.4, “Understanding patches”</a> for a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	479	description of the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	480	format), one per message. You can send a binary bundle
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	481	instead with the <code class="option">hg -b</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	482	option.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	483	<li class="listitem"><p id="x_53f"></a>Unified diffs are normally prefaced with a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	484	metadata header. You can omit this, and send unadorned
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	485	diffs, with the <code class="option">hg
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	486	--plain</code> option.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	487	<li class="listitem"><p id="x_540"></a>Diffs are normally sent <span class="quote">“<span class="quote">inline</span>”</span>,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	488	in the same body part as the description of a patch. This
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	489	makes it easiest for the largest number of readers to
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	490	quote and respond to parts of a diff, as some mail clients
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	491	will only quote the first MIME body part in a message. If
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	492	you'd prefer to send the description and the diff in
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	493	separate body parts, use the <code class="option">hg -a</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	494	option.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	495	<li class="listitem"><p id="x_541"></a>Instead of sending mail messages, you can
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	496	write them to an <code class="literal">mbox</code>-format mail
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	497	folder using the <code class="option">hg -m</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	498	option. That option takes one argument, the name of the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	499	file to write to.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	500	<li class="listitem"><p id="x_542"></a>If you would like to add a
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	501	<span class="command"><strong>diffstat</strong></span>-format summary to each patch,
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	502	and one to the introductory message, use the <code class="option">hg -d</code>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	503	option. The <span class="command"><strong>diffstat</strong></span> command displays
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	504	a table containing the name of each file patched, the
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	505	number of lines affected, and a histogram showing how much
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	506	each file is modified. This gives readers a qualitative
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	507	glance at how complex a patch is.</p></li>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	508	</ul></div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	509	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	510	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	511	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	512	<div class="navfooter">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	513	<hr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	514	<table width="100%" summary="Navigation footer">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	515	<tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	516	<td width="40%" align="left">
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	517	<a accesskey="p" href="advanced-uses-of-mercurial-queues.html">Prev</a> </td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	518	<td width="20%" align="center"> </td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	519	<td width="40%" align="right"> <a accesskey="n" href="migrating-to-mercurial.html">Next</a>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	520	</td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	521	</tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	522	<tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	523	<td width="40%" align="left" valign="top">Chapter 13. Advanced uses of Mercurial Queues </td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	524	<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	525	<td width="40%" align="right" valign="top"> Appendix A. Migrating to Mercurial</td>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	526	</tr>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	527	</table>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	528	</div>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	529	</body>
8083d21c0020 The first commit of all the required files for the review app amit@thunder parents: diff changeset	530	</html>

author	amit@thunder
	Thu, 25 Feb 2010 00:45:20 +0530
changeset 28	514098969b11
parent 2	52d12eb31c30
permissions	-rwxr-xr-x