1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/fr/appB-mq-ref.xml	Mon Nov 30 10:57:42 2009 +0100
     1.3 @@ -0,0 +1,563 @@
     1.4 +<!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
     1.5 +
     1.6 +<appendix id="chap:mqref">
     1.7 +  <?dbhtml filename="mercurial-queues-reference.html"?>
     1.8 +  <title>Mercurial Queues reference</title>
     1.9 +
    1.10 +  <sect1 id="sec:mqref:cmdref">
    1.11 +    <title>MQ command reference</title>
    1.12 +
    1.13 +    <para id="x_5e8">For an overview of the commands provided by MQ, use the
    1.14 +      command <command role="hg-cmd">hg help mq</command>.</para>
    1.15 +
    1.16 +    <sect2>
    1.17 +      <title><command role="hg-ext-mq">qapplied</command>&emdash;print
    1.18 +	applied patches</title>
    1.19 +
    1.20 +      <para id="x_5e9">The <command role="hg-ext-mq">qapplied</command> command
    1.21 +	prints the current stack of applied patches.  Patches are
    1.22 +	printed in oldest-to-newest order, so the last patch in the
    1.23 +	list is the <quote>top</quote> patch.</para>
    1.24 +
    1.25 +    </sect2>
    1.26 +    <sect2>
    1.27 +      <title><command role="hg-ext-mq">qcommit</command>&emdash;commit
    1.28 +	changes in the queue repository</title>
    1.29 +
    1.30 +      <para id="x_5ea">The <command role="hg-ext-mq">qcommit</command> command
    1.31 +	commits any outstanding changes in the <filename
    1.32 +	  role="special" class="directory">.hg/patches</filename>
    1.33 +	repository.  This command only works if the <filename
    1.34 +	  role="special" class="directory">.hg/patches</filename>
    1.35 +	directory is a repository, i.e. you created the directory
    1.36 +	using <command role="hg-cmd">hg qinit <option
    1.37 +	    role="hg-ext-mq-cmd-qinit-opt">-c</option></command> or
    1.38 +	ran <command role="hg-cmd">hg init</command> in the directory
    1.39 +	after running <command
    1.40 +	  role="hg-ext-mq">qinit</command>.</para>
    1.41 +
    1.42 +      <para id="x_5eb">This command is shorthand for <command role="hg-cmd">hg
    1.43 +	  commit --cwd .hg/patches</command>.</para>
    1.44 +    </sect2>
    1.45 +    <sect2>
    1.46 +	<title><command
    1.47 +	  role="hg-ext-mq">qdelete</command>&emdash;delete a patch
    1.48 +	from the <filename role="special">series</filename>
    1.49 +	file</title>
    1.50 +
    1.51 +      <para id="x_5ec">The <command role="hg-ext-mq">qdelete</command> command
    1.52 +	removes the entry for a patch from the <filename
    1.53 +	  role="special">series</filename> file in the <filename
    1.54 +	  role="special" class="directory">.hg/patches</filename>
    1.55 +	directory.  It does not pop the patch if the patch is already
    1.56 +	applied.  By default, it does not delete the patch file; use
    1.57 +	the <option role="hg-ext-mq-cmd-qdel-opt">-f</option> option
    1.58 +	to do that.</para>
    1.59 +
    1.60 +      <para id="x_5ed">Options:</para>
    1.61 +      <itemizedlist>
    1.62 +	<listitem><para id="x_5ee"><option
    1.63 +	      role="hg-ext-mq-cmd-qdel-opt">-f</option>: Delete the
    1.64 +	    patch file.</para>
    1.65 +	</listitem></itemizedlist>
    1.66 +
    1.67 +    </sect2>
    1.68 +    <sect2>
    1.69 +      <title><command role="hg-ext-mq">qdiff</command>&emdash;print a
    1.70 +	diff of the topmost applied patch</title>
    1.71 +
    1.72 +      <para id="x_5ef">The <command role="hg-ext-mq">qdiff</command> command
    1.73 +	prints a diff of the topmost applied patch. It is equivalent
    1.74 +	to <command role="hg-cmd">hg diff -r-2:-1</command>.</para>
    1.75 +
    1.76 +    </sect2>
    1.77 +    <sect2>
    1.78 +      <title><command role="hg-ext-mq">qfold</command>&emdash;move
    1.79 +	applied patches into repository history</title>
    1.80 +
    1.81 +      <para id="x_72d">The <command>hg qfinish</command> command converts the
    1.82 +	specified applied patches into permanent changes by moving
    1.83 +	them out of MQ's control so that they will be treated as
    1.84 +	normal repository history.</para>
    1.85 +    </sect2>
    1.86 +
    1.87 +    <sect2>
    1.88 +      <title><command role="hg-ext-mq">qfold</command>&emdash;merge
    1.89 +	(<quote>fold</quote>) several patches into one</title>
    1.90 +
    1.91 +      <para id="x_5f0">The <command role="hg-ext-mq">qfold</command> command
    1.92 +	merges multiple patches into the topmost applied patch, so
    1.93 +	that the topmost applied patch makes the union of all of the
    1.94 +	changes in the patches in question.</para>
    1.95 +
    1.96 +      <para id="x_5f1">The patches to fold must not be applied; <command
    1.97 +	  role="hg-ext-mq">qfold</command> will exit with an error if
    1.98 +	any is.  The order in which patches are folded is significant;
    1.99 +	<command role="hg-cmd">hg qfold a b</command> means
   1.100 +	<quote>apply the current topmost patch, followed by
   1.101 +	  <literal>a</literal>, followed by
   1.102 +	  <literal>b</literal></quote>.</para>
   1.103 +
   1.104 +      <para id="x_5f2">The comments from the folded patches are appended to the
   1.105 +	comments of the destination patch, with each block of comments
   1.106 +	separated by three asterisk
   1.107 +	(<quote><literal>*</literal></quote>) characters.  Use the
   1.108 +	<option role="hg-ext-mq-cmd-qfold-opt">-e</option> option to
   1.109 +	edit the commit message for the combined patch/changeset after
   1.110 +	the folding has completed.</para>
   1.111 +
   1.112 +      <para id="x_5f3">Options:</para>
   1.113 +      <itemizedlist>
   1.114 +	<listitem><para id="x_5f4"><option
   1.115 +	      role="hg-ext-mq-cmd-qfold-opt">-e</option>: Edit the
   1.116 +	    commit message and patch description for the newly folded
   1.117 +	    patch.</para>
   1.118 +	</listitem>
   1.119 +	<listitem><para id="x_5f5"><option
   1.120 +	      role="hg-ext-mq-cmd-qfold-opt">-l</option>: Use the
   1.121 +	    contents of the given file as the new commit message and
   1.122 +	    patch description for the folded patch.</para>
   1.123 +	</listitem>
   1.124 +	<listitem><para id="x_5f6"><option
   1.125 +	      role="hg-ext-mq-cmd-qfold-opt">-m</option>: Use the
   1.126 +	    given text as the new commit message and patch description
   1.127 +	    for the folded patch.</para>
   1.128 +	</listitem></itemizedlist>
   1.129 +
   1.130 +    </sect2>
   1.131 +    <sect2>
   1.132 +      <title><command
   1.133 +	  role="hg-ext-mq">qheader</command>&emdash;display the
   1.134 +	header/description of a patch</title>
   1.135 +
   1.136 +      <para id="x_5f7">The <command role="hg-ext-mq">qheader</command> command
   1.137 +	prints the header, or description, of a patch.  By default, it
   1.138 +	prints the header of the topmost applied patch. Given an
   1.139 +	argument, it prints the header of the named patch.</para>
   1.140 +
   1.141 +    </sect2>
   1.142 +    <sect2>
   1.143 +      <title><command role="hg-ext-mq">qimport</command>&emdash;import
   1.144 +	a third-party patch into the queue</title>
   1.145 +
   1.146 +      <para id="x_5f8">The <command role="hg-ext-mq">qimport</command> command
   1.147 +	adds an entry for an external patch to the <filename
   1.148 +	  role="special">series</filename> file, and copies the patch
   1.149 +	into the <filename role="special"
   1.150 +	  class="directory">.hg/patches</filename> directory.  It adds
   1.151 +	the entry immediately after the topmost applied patch, but
   1.152 +	does not push the patch.</para>
   1.153 +
   1.154 +      <para id="x_5f9">If the <filename role="special"
   1.155 +	  class="directory">.hg/patches</filename> directory is a
   1.156 +	repository, <command role="hg-ext-mq">qimport</command>
   1.157 +	automatically does an <command role="hg-cmd">hg add</command>
   1.158 +	of the imported patch.</para>
   1.159 +
   1.160 +    </sect2>
   1.161 +    <sect2>
   1.162 +      <title><command role="hg-ext-mq">qinit</command>&emdash;prepare
   1.163 +	a repository to work with MQ</title>
   1.164 +
   1.165 +      <para id="x_5fa">The <command role="hg-ext-mq">qinit</command> command
   1.166 +	prepares a repository to work with MQ.  It creates a directory
   1.167 +	called <filename role="special"
   1.168 +	  class="directory">.hg/patches</filename>.</para>
   1.169 +
   1.170 +      <para id="x_5fb">Options:</para>
   1.171 +      <itemizedlist>
   1.172 +	<listitem><para id="x_5fc"><option
   1.173 +	      role="hg-ext-mq-cmd-qinit-opt">-c</option>: Create
   1.174 +	    <filename role="special"
   1.175 +	      class="directory">.hg/patches</filename> as a repository
   1.176 +	    in its own right.  Also creates a <filename
   1.177 +	      role="special">.hgignore</filename> file that will
   1.178 +	    ignore the <filename role="special">status</filename>
   1.179 +	    file.</para>
   1.180 +	</listitem></itemizedlist>
   1.181 +
   1.182 +      <para id="x_5fd">When the <filename role="special"
   1.183 +	  class="directory">.hg/patches</filename> directory is a
   1.184 +	repository, the <command role="hg-ext-mq">qimport</command>
   1.185 +	and <command role="hg-ext-mq">qnew</command> commands
   1.186 +	automatically <command role="hg-cmd">hg add</command> new
   1.187 +	patches.</para>
   1.188 +
   1.189 +    </sect2>
   1.190 +    <sect2>
   1.191 +      <title><command role="hg-ext-mq">qnew</command>&emdash;create a
   1.192 +	new patch</title>
   1.193 +
   1.194 +      <para id="x_5fe">The <command role="hg-ext-mq">qnew</command> command
   1.195 +	creates a new patch.  It takes one mandatory argument, the
   1.196 +	name to use for the patch file.  The newly created patch is
   1.197 +	created empty by default.  It is added to the <filename
   1.198 +	  role="special">series</filename> file after the current
   1.199 +	topmost applied patch, and is immediately pushed on top of
   1.200 +	that patch.</para>
   1.201 +
   1.202 +      <para id="x_5ff">If <command role="hg-ext-mq">qnew</command> finds modified
   1.203 +	files in the working directory, it will refuse to create a new
   1.204 +	patch unless the <option
   1.205 +	  role="hg-ext-mq-cmd-qnew-opt">-f</option> option is used
   1.206 +	(see below).  This behavior allows you to <command
   1.207 +	  role="hg-ext-mq">qrefresh</command> your topmost applied
   1.208 +	patch before you apply a new patch on top of it.</para>
   1.209 +
   1.210 +      <para id="x_600">Options:</para>
   1.211 +      <itemizedlist>
   1.212 +	<listitem><para id="x_601"><option
   1.213 +	      role="hg-ext-mq-cmd-qnew-opt">-f</option>: Create a new
   1.214 +	    patch if the contents of the working directory are
   1.215 +	    modified.  Any outstanding modifications are added to the
   1.216 +	    newly created patch, so after this command completes, the
   1.217 +	    working directory will no longer be modified.</para>
   1.218 +	</listitem>
   1.219 +	<listitem><para id="x_602"><option
   1.220 +	      role="hg-ext-mq-cmd-qnew-opt">-m</option>: Use the given
   1.221 +	    text as the commit message. This text will be stored at
   1.222 +	    the beginning of the patch file, before the patch
   1.223 +	    data.</para>
   1.224 +	</listitem></itemizedlist>
   1.225 +
   1.226 +    </sect2>
   1.227 +    <sect2>
   1.228 +      <title><command role="hg-ext-mq">qnext</command>&emdash;print
   1.229 +	the name of the next patch</title>
   1.230 +
   1.231 +      <para id="x_603">The <command role="hg-ext-mq">qnext</command> command
   1.232 +	prints the name name of the next patch in the <filename
   1.233 +	  role="special">series</filename> file after the topmost
   1.234 +	applied patch.  This patch will become the topmost applied
   1.235 +	patch if you run <command
   1.236 +	  role="hg-ext-mq">qpush</command>.</para>
   1.237 +
   1.238 +    </sect2>
   1.239 +    <sect2>
   1.240 +      <title><command role="hg-ext-mq">qpop</command>&emdash;pop
   1.241 +	patches off the stack</title>
   1.242 +
   1.243 +      <para id="x_604">The <command role="hg-ext-mq">qpop</command> command
   1.244 +	removes applied patches from the top of the stack of applied
   1.245 +	patches.  By default, it removes only one patch.</para>
   1.246 +
   1.247 +      <para id="x_605">This command removes the changesets that represent the
   1.248 +	popped patches from the repository, and updates the working
   1.249 +	directory to undo the effects of the patches.</para>
   1.250 +
   1.251 +      <para id="x_606">This command takes an optional argument, which it uses as
   1.252 +	the name or index of the patch to pop to.  If given a name, it
   1.253 +	will pop patches until the named patch is the topmost applied
   1.254 +	patch.  If given a number, <command
   1.255 +	  role="hg-ext-mq">qpop</command> treats the number as an
   1.256 +	index into the entries in the series file, counting from zero
   1.257 +	(empty lines and lines containing only comments do not count).
   1.258 +	It pops patches until the patch identified by the given index
   1.259 +	is the topmost applied patch.</para>
   1.260 +
   1.261 +      <para id="x_607">The <command role="hg-ext-mq">qpop</command> command does
   1.262 +	not read or write patches or the <filename
   1.263 +	  role="special">series</filename> file.  It is thus safe to
   1.264 +	<command role="hg-ext-mq">qpop</command> a patch that you have
   1.265 +	removed from the <filename role="special">series</filename>
   1.266 +	file, or a patch that you have renamed or deleted entirely.
   1.267 +	In the latter two cases, use the name of the patch as it was
   1.268 +	when you applied it.</para>
   1.269 +
   1.270 +      <para id="x_608">By default, the <command role="hg-ext-mq">qpop</command>
   1.271 +	command will not pop any patches if the working directory has
   1.272 +	been modified.  You can override this behavior using the
   1.273 +	<option role="hg-ext-mq-cmd-qpop-opt">-f</option> option,
   1.274 +	which reverts all modifications in the working
   1.275 +	directory.</para>
   1.276 +
   1.277 +      <para id="x_609">Options:</para>
   1.278 +      <itemizedlist>
   1.279 +	<listitem><para id="x_60a"><option
   1.280 +	      role="hg-ext-mq-cmd-qpop-opt">-a</option>: Pop all
   1.281 +	    applied patches.  This returns the repository to its state
   1.282 +	    before you applied any patches.</para>
   1.283 +	</listitem>
   1.284 +	<listitem><para id="x_60b"><option
   1.285 +	      role="hg-ext-mq-cmd-qpop-opt">-f</option>: Forcibly
   1.286 +	    revert any modifications to the working directory when
   1.287 +	    popping.</para>
   1.288 +	</listitem>
   1.289 +	<listitem><para id="x_60c"><option
   1.290 +	      role="hg-ext-mq-cmd-qpop-opt">-n</option>: Pop a patch
   1.291 +	    from the named queue.</para>
   1.292 +	</listitem></itemizedlist>
   1.293 +
   1.294 +      <para id="x_60d">The <command role="hg-ext-mq">qpop</command> command
   1.295 +	removes one line from the end of the <filename
   1.296 +	  role="special">status</filename> file for each patch that it
   1.297 +	pops.</para>
   1.298 +
   1.299 +    </sect2>
   1.300 +    <sect2>
   1.301 +      <title><command role="hg-ext-mq">qprev</command>&emdash;print
   1.302 +	the name of the previous patch</title>
   1.303 +
   1.304 +      <para id="x_60e">The <command role="hg-ext-mq">qprev</command> command
   1.305 +	prints the name of the patch in the <filename
   1.306 +	  role="special">series</filename> file that comes before the
   1.307 +	topmost applied patch. This will become the topmost applied
   1.308 +	patch if you run <command
   1.309 +	  role="hg-ext-mq">qpop</command>.</para>
   1.310 +
   1.311 +    </sect2>
   1.312 +    <sect2 id="sec:mqref:cmd:qpush">
   1.313 +      <title><command role="hg-ext-mq">qpush</command>&emdash;push
   1.314 +	patches onto the stack</title>
   1.315 +
   1.316 +      <para id="x_60f">The <command role="hg-ext-mq">qpush</command> command adds
   1.317 +	patches onto the applied stack.  By default, it adds only one
   1.318 +	patch.</para>
   1.319 +
   1.320 +      <para id="x_610">This command creates a new changeset to represent each
   1.321 +	applied patch, and updates the working directory to apply the
   1.322 +	effects of the patches.</para>
   1.323 +
   1.324 +      <para id="x_611">The default data used when creating a changeset are as
   1.325 +	follows:</para>
   1.326 +      <itemizedlist>
   1.327 +	<listitem><para id="x_612">The commit date and time zone are the current
   1.328 +	    date and time zone.  Because these data are used to
   1.329 +	    compute the identity of a changeset, this means that if
   1.330 +	    you <command role="hg-ext-mq">qpop</command> a patch and
   1.331 +	    <command role="hg-ext-mq">qpush</command> it again, the
   1.332 +	    changeset that you push will have a different identity
   1.333 +	    than the changeset you popped.</para>
   1.334 +	</listitem>
   1.335 +	<listitem><para id="x_613">The author is the same as the default used by
   1.336 +	    the <command role="hg-cmd">hg commit</command>
   1.337 +	    command.</para>
   1.338 +	</listitem>
   1.339 +	<listitem><para id="x_614">The commit message is any text from the patch
   1.340 +	    file that comes before the first diff header.  If there is
   1.341 +	    no such text, a default commit message is used that
   1.342 +	    identifies the name of the patch.</para>
   1.343 +	</listitem></itemizedlist>
   1.344 +      <para id="x_615">If a patch contains a Mercurial patch header,
   1.345 +	the information in the patch header overrides these
   1.346 +	defaults.</para>
   1.347 +
   1.348 +      <para id="x_616">Options:</para>
   1.349 +      <itemizedlist>
   1.350 +	<listitem><para id="x_617"><option
   1.351 +	      role="hg-ext-mq-cmd-qpush-opt">-a</option>: Push all
   1.352 +	    unapplied patches from the <filename
   1.353 +	      role="special">series</filename> file until there are
   1.354 +	    none left to push.</para>
   1.355 +	</listitem>
   1.356 +	<listitem><para id="x_618"><option
   1.357 +	      role="hg-ext-mq-cmd-qpush-opt">-l</option>: Add the name
   1.358 +	    of the patch to the end of the commit message.</para>
   1.359 +	</listitem>
   1.360 +	<listitem><para id="x_619"><option
   1.361 +	      role="hg-ext-mq-cmd-qpush-opt">-m</option>: If a patch
   1.362 +	    fails to apply cleanly, use the entry for the patch in
   1.363 +	    another saved queue to compute the parameters for a
   1.364 +	    three-way merge, and perform a three-way merge using the
   1.365 +	    normal Mercurial merge machinery.  Use the resolution of
   1.366 +	    the merge as the new patch content.</para>
   1.367 +	</listitem>
   1.368 +	<listitem><para id="x_61a"><option
   1.369 +	      role="hg-ext-mq-cmd-qpush-opt">-n</option>: Use the
   1.370 +	    named queue if merging while pushing.</para>
   1.371 +	</listitem></itemizedlist>
   1.372 +
   1.373 +      <para id="x_61b">The <command role="hg-ext-mq">qpush</command> command
   1.374 +	reads, but does not modify, the <filename
   1.375 +	  role="special">series</filename> file.  It appends one line
   1.376 +	to the <command role="hg-cmd">hg status</command> file for
   1.377 +	each patch that it pushes.</para>
   1.378 +
   1.379 +    </sect2>
   1.380 +    <sect2>
   1.381 +      <title><command
   1.382 +	  role="hg-ext-mq">qrefresh</command>&emdash;update the
   1.383 +	topmost applied patch</title>
   1.384 +
   1.385 +      <para id="x_61c">The <command role="hg-ext-mq">qrefresh</command> command
   1.386 +	updates the topmost applied patch.  It modifies the patch,
   1.387 +	removes the old changeset that represented the patch, and
   1.388 +	creates a new changeset to represent the modified
   1.389 +	patch.</para>
   1.390 +
   1.391 +      <para id="x_61d">The <command role="hg-ext-mq">qrefresh</command> command
   1.392 +	looks for the following modifications:</para>
   1.393 +      <itemizedlist>
   1.394 +	<listitem><para id="x_61e">Changes to the commit message, i.e. the text
   1.395 +	    before the first diff header in the patch file, are
   1.396 +	    reflected in the new changeset that represents the
   1.397 +	    patch.</para>
   1.398 +	</listitem>
   1.399 +	<listitem><para id="x_61f">Modifications to tracked files in the working
   1.400 +	    directory are added to the patch.</para>
   1.401 +	</listitem>
   1.402 +	<listitem><para id="x_620">Changes to the files tracked using <command
   1.403 +	      role="hg-cmd">hg add</command>, <command
   1.404 +	      role="hg-cmd">hg copy</command>, <command
   1.405 +	      role="hg-cmd">hg remove</command>, or <command
   1.406 +	      role="hg-cmd">hg rename</command>.  Added files and copy
   1.407 +	    and rename destinations are added to the patch, while
   1.408 +	    removed files and rename sources are removed.</para>
   1.409 +	</listitem></itemizedlist>
   1.410 +
   1.411 +      <para id="x_621">Even if <command role="hg-ext-mq">qrefresh</command>
   1.412 +	detects no changes, it still recreates the changeset that
   1.413 +	represents the patch.  This causes the identity of the
   1.414 +	changeset to differ from the previous changeset that
   1.415 +	identified the patch.</para>
   1.416 +
   1.417 +      <para id="x_622">Options:</para>
   1.418 +      <itemizedlist>
   1.419 +	<listitem><para id="x_623"><option
   1.420 +	      role="hg-ext-mq-cmd-qrefresh-opt">-e</option>: Modify
   1.421 +	    the commit and patch description, using the preferred text
   1.422 +	    editor.</para>
   1.423 +	</listitem>
   1.424 +	<listitem><para id="x_624"><option
   1.425 +	      role="hg-ext-mq-cmd-qrefresh-opt">-m</option>: Modify
   1.426 +	    the commit message and patch description, using the given
   1.427 +	    text.</para>
   1.428 +	</listitem>
   1.429 +	<listitem><para id="x_625"><option
   1.430 +	      role="hg-ext-mq-cmd-qrefresh-opt">-l</option>: Modify
   1.431 +	    the commit message and patch description, using text from
   1.432 +	    the given file.</para>
   1.433 +	</listitem></itemizedlist>
   1.434 +
   1.435 +    </sect2>
   1.436 +    <sect2>
   1.437 +      <title><command role="hg-ext-mq">qrename</command>&emdash;rename
   1.438 +	a patch</title>
   1.439 +
   1.440 +      <para id="x_626">The <command role="hg-ext-mq">qrename</command> command
   1.441 +	renames a patch, and changes the entry for the patch in the
   1.442 +	<filename role="special">series</filename> file.</para>
   1.443 +
   1.444 +      <para id="x_627">With a single argument, <command
   1.445 +	  role="hg-ext-mq">qrename</command> renames the topmost
   1.446 +	applied patch.  With two arguments, it renames its first
   1.447 +	argument to its second.</para>
   1.448 +
   1.449 +    </sect2>
   1.450 +    <sect2>
   1.451 +      <title><command role="hg-ext-mq">qseries</command>&emdash;print
   1.452 +	the entire patch series</title>
   1.453 +
   1.454 +      <para id="x_62a">The <command role="hg-ext-mq">qseries</command> command
   1.455 +	prints the entire patch series from the <filename
   1.456 +	  role="special">series</filename> file.  It prints only patch
   1.457 +	names, not empty lines or comments.  It prints in order from
   1.458 +	first to be applied to last.</para>
   1.459 +
   1.460 +    </sect2>
   1.461 +    <sect2>
   1.462 +      <title><command role="hg-ext-mq">qtop</command>&emdash;print the
   1.463 +	name of the current patch</title>
   1.464 +
   1.465 +      <para id="x_62b">The <command role="hg-ext-mq">qtop</command> prints the
   1.466 +	name of the topmost currently applied patch.</para>
   1.467 +
   1.468 +    </sect2>
   1.469 +    <sect2>
   1.470 +      <title><command
   1.471 +	  role="hg-ext-mq">qunapplied</command>&emdash;print patches
   1.472 +	not yet applied</title>
   1.473 +
   1.474 +      <para id="x_62c">The <command role="hg-ext-mq">qunapplied</command> command
   1.475 +	prints the names of patches from the <filename
   1.476 +	  role="special">series</filename> file that are not yet
   1.477 +	applied.  It prints them in order from the next patch that
   1.478 +	will be pushed to the last.</para>
   1.479 +
   1.480 +    </sect2>
   1.481 +    <sect2>
   1.482 +      <title><command role="hg-cmd">hg strip</command>&emdash;remove a
   1.483 +	revision and descendants</title>
   1.484 +
   1.485 +      <para id="x_62d">The <command role="hg-cmd">hg strip</command> command
   1.486 +	removes a revision, and all of its descendants, from the
   1.487 +	repository.  It undoes the effects of the removed revisions
   1.488 +	from the repository, and updates the working directory to the
   1.489 +	first parent of the removed revision.</para>
   1.490 +
   1.491 +      <para id="x_62e">The <command role="hg-cmd">hg strip</command> command
   1.492 +	saves a backup of the removed changesets in a bundle, so that
   1.493 +	they can be reapplied if removed in error.</para>
   1.494 +
   1.495 +      <para id="x_62f">Options:</para>
   1.496 +      <itemizedlist>
   1.497 +	<listitem><para id="x_630"><option role="hg-opt-strip">-b</option>: Save
   1.498 +	    unrelated changesets that are intermixed with the stripped
   1.499 +	    changesets in the backup bundle.</para>
   1.500 +	</listitem>
   1.501 +	<listitem><para id="x_631"><option role="hg-opt-strip">-f</option>: If a
   1.502 +	    branch has multiple heads, remove all heads.</para>
   1.503 +	</listitem>
   1.504 +	<listitem><para id="x_632"><option role="hg-opt-strip">-n</option>: Do
   1.505 +	    not save a backup bundle.</para>
   1.506 +	</listitem></itemizedlist>
   1.507 +
   1.508 +    </sect2>
   1.509 +  </sect1>
   1.510 +  <sect1>
   1.511 +    <title>MQ file reference</title>
   1.512 +
   1.513 +    <sect2>
   1.514 +      <title>The <filename role="special">series</filename>
   1.515 +	file</title>
   1.516 +
   1.517 +      <para id="x_633">The <filename role="special">series</filename> file
   1.518 +	contains a list of the names of all patches that MQ can apply.
   1.519 +	It is represented as a list of names, with one name saved per
   1.520 +	line.  Leading and trailing white space in each line are
   1.521 +	ignored.</para>
   1.522 +
   1.523 +      <para id="x_634">Lines may contain comments.  A comment begins with the
   1.524 +	<quote><literal>#</literal></quote> character, and extends to
   1.525 +	the end of the line.  Empty lines, and lines that contain only
   1.526 +	comments, are ignored.</para>
   1.527 +
   1.528 +      <para id="x_635">You will often need to edit the <filename
   1.529 +	  role="special">series</filename> file by hand, hence the
   1.530 +	support for comments and empty lines noted above.  For
   1.531 +	example, you can comment out a patch temporarily, and <command
   1.532 +	  role="hg-ext-mq">qpush</command> will skip over that patch
   1.533 +	when applying patches.  You can also change the order in which
   1.534 +	patches are applied by reordering their entries in the
   1.535 +	<filename role="special">series</filename> file.</para>
   1.536 +
   1.537 +      <para id="x_636">Placing the <filename role="special">series</filename>
   1.538 +	file under revision control is also supported; it is a good
   1.539 +	idea to place all of the patches that it refers to under
   1.540 +	revision control, as well.  If you create a patch directory
   1.541 +	using the <option role="hg-ext-mq-cmd-qinit-opt">-c</option>
   1.542 +	option to <command role="hg-ext-mq">qinit</command>, this will
   1.543 +	be done for you automatically.</para>
   1.544 +
   1.545 +    </sect2>
   1.546 +    <sect2>
   1.547 +      <title>The <filename role="special">status</filename>
   1.548 +	file</title>
   1.549 +
   1.550 +      <para id="x_637">The <filename role="special">status</filename> file
   1.551 +	contains the names and changeset hashes of all patches that MQ
   1.552 +	currently has applied.  Unlike the <filename
   1.553 +	  role="special">series</filename> file, this file is not
   1.554 +	intended for editing.  You should not place this file under
   1.555 +	revision control, or modify it in any way.  It is used by MQ
   1.556 +	strictly for internal book-keeping.</para>
   1.557 +
   1.558 +    </sect2>
   1.559 +  </sect1>
   1.560 +</appendix>
   1.561 +
   1.562 +<!--
   1.563 +local variables: 
   1.564 +sgml-parent-document: ("00book.xml" "book" "appendix")
   1.565 +end:
   1.566 +-->