Mercurial > hgbook
diff en/ch13-mq-collab.xml @ 666:8fcd44708f41
Uncomment all the mangled interaction examples.
author | Bryan O'Sullivan <bos@serpentine.com> |
---|---|
date | Mon, 09 Mar 2009 23:22:09 -0700 |
parents | b90b024729f1 |
children | 13513d2a128d |
line wrap: on
line diff
--- a/en/ch13-mq-collab.xml Mon Mar 09 22:55:38 2009 -0700 +++ b/en/ch13-mq-collab.xml Mon Mar 09 23:22:09 2009 -0700 @@ -108,10 +108,13 @@ situation. MQ provides a feature called <quote>guards</quote> (which originates with quilt's <literal>guards</literal> command) that does just this. To start off, let's create a - simple repository for experimenting in. <!-- - &interaction.mq.guards.init; --> This gives us a tiny repository - that contains two patches that don't have any dependencies on - each other, because they touch different files.</para> + simple repository for experimenting in.</para> + + &interaction.mq.guards.init; + + <para>This gives us a tiny repository that contains two patches + that don't have any dependencies on each other, because they + touch different files.</para> <para>The idea behind conditional application is that you can <quote>tag</quote> a patch with a <emphasis>guard</emphasis>, @@ -133,14 +136,20 @@ <para>The <command role="hg-ext-mq">qguard</command> command lets you determine which guards should apply to a patch, or display the guards that are already in effect. Without any arguments, it - displays the guards on the current topmost patch. <!-- - &interaction.mq.guards.qguard; --> To set a positive guard on a - patch, prefix the name of the guard with a - <quote><literal>+</literal></quote>. <!-- - &interaction.mq.guards.qguard.pos; --> To set a negative guard + displays the guards on the current topmost patch.</para> + + &interaction.mq.guards.qguard; + + <para>To set a positive guard on a patch, prefix the name of the + guard with a <quote><literal>+</literal></quote>.</para> + + &interaction.mq.guards.qguard.pos; + + <para>To set a negative guard on a patch, prefix the name of the guard with a - <quote><literal>-</literal></quote>. <!-- - &interaction.mq.guards.qguard.neg; --></para> + <quote><literal>-</literal></quote>.</para> + + &interaction.mq.guards.qguard.neg; <note> <para> The <command role="hg-ext-mq">qguard</command> command @@ -158,8 +167,9 @@ other words, you don't have to use the <command role="hg-ext-mq">qguard</command> command if you don't want to; it's okay to simply edit the <filename - role="special">series</filename> file.) <!-- - &interaction.mq.guards.series; --></para> + role="special">series</filename> file.)</para> + + &interaction.mq.guards.series; </sect1> <sect1> @@ -175,26 +185,38 @@ <para>With no arguments, the <command role="hg-ext-mq">qselect</command> command lists the guards currently in effect, one per line of output. Each argument is - treated as the name of a guard to apply. <!-- - &interaction.mq.guards.qselect.foo; --> In case you're - interested, the currently selected guards are stored in the - <filename role="special">guards</filename> file. <!-- - &interaction.mq.guards.qselect.cat; --> We can see the effect - the selected guards have when we run <command - role="hg-ext-mq">qpush</command>. <!-- - &interaction.mq.guards.qselect.qpush; --></para> + treated as the name of a guard to apply.</para> + + &interaction.mq.guards.qselect.foo; + + <para>In case you're interested, the currently selected guards are + stored in the <filename role="special">guards</filename> file.</para> + + &interaction.mq.guards.qselect.cat; + + <para>We can see the effect the selected guards have when we run + <command role="hg-ext-mq">qpush</command>.</para> + + &interaction.mq.guards.qselect.qpush; <para>A guard cannot start with a <quote><literal>+</literal></quote> or <quote><literal>-</literal></quote> character. The name of a guard must not contain white space, but most other characters are acceptable. If you try to use a guard with an invalid name, - MQ will complain: <!-- &interaction.mq.guards.qselect.error; --> - Changing the selected guards changes the patches that are - applied. <!-- &interaction.mq.guards.qselect.quux; --> You can - see in the example below that negative guards take precedence - over positive guards. <!-- - &interaction.mq.guards.qselect.foobar; --></para> + MQ will complain:</para> + + &interaction.mq.guards.qselect.error; + + <para>Changing the selected guards changes the patches that are + applied.</para> + + &interaction.mq.guards.qselect.quux; + + <para>You can see in the example below that negative guards take + precedence over positive guards.</para> + + &interaction.mq.guards.qselect.foobar; </sect1> <sect1>