hgbook
diff en/ch02-tour-basic.xml @ 566:27043f385f3f
Get autogeneration of examples more or less working.
author | Bryan O'Sullivan <bos@serpentine.com> |
---|---|
date | Mon Mar 09 22:55:38 2009 -0700 (2009-03-09) |
parents | b90b024729f1 |
children | 13513d2a128d |
line diff
1.1 --- a/en/ch02-tour-basic.xml Wed Feb 18 00:22:09 2009 -0800 1.2 +++ b/en/ch02-tour-basic.xml Mon Mar 09 22:55:38 2009 -0700 1.3 @@ -104,7 +104,7 @@ 1.4 that it prints isn't so important; it's whether it prints 1.5 anything at all that we care about.</para> 1.6 1.7 - <!-- &interaction.tour.version; --> 1.8 + &interaction.tour.version; 1.9 1.10 <sect2> 1.11 <title>Built-in help</title> 1.12 @@ -118,7 +118,7 @@ 1.13 help on a specific command (as below), it prints more 1.14 detailed information.</para> 1.15 1.16 - <!-- &interaction.tour.help; --> 1.17 + &interaction.tour.help; 1.18 1.19 <para>For a more impressive level of detail (which you won't 1.20 usually need) run <command role="hg-cmd">hg help <option 1.21 @@ -155,13 +155,13 @@ 1.22 called <command role="hg-cmd">hg clone</command>, because it 1.23 creates an identical copy of an existing repository.</para> 1.24 1.25 - <!-- &interaction.tour.clone; --> 1.26 + &interaction.tour.clone; 1.27 1.28 <para>If our clone succeeded, we should now have a local 1.29 directory called <filename class="directory">hello</filename>. 1.30 This directory will contain some files.</para> 1.31 1.32 - <!-- &interaction.tour.ls; --> 1.33 + &interaction.tour.ls; 1.34 1.35 <para>These files have the same contents and history in our 1.36 repository as they do in the repository we cloned.</para> 1.37 @@ -186,7 +186,7 @@ 1.38 class="directory">.hg</filename>. This is where Mercurial 1.39 keeps all of its metadata for the repository.</para> 1.40 1.41 - <!-- &interaction.tour.ls-a; --> 1.42 + &interaction.tour.ls-a; 1.43 1.44 <para>The contents of the <filename 1.45 class="directory">.hg</filename> directory and its 1.46 @@ -216,7 +216,7 @@ 1.47 role="hg-cmd">hg log</command> command gives us a view of 1.48 history.</para> 1.49 1.50 - <!-- &interaction.tour.log; --> 1.51 + &interaction.tour.log; 1.52 1.53 <para>By default, this command prints a brief paragraph of output 1.54 for each change to the project that was recorded. In Mercurial 1.55 @@ -324,7 +324,7 @@ 1.56 either a revision number or a long-form changeset identifier, 1.57 and you can provide as many revisions as you want.</para> 1.58 1.59 - <!-- &interaction.tour.log-r; --> 1.60 + &interaction.tour.log-r; 1.61 1.62 <para>If you want to see the history of several revisions 1.63 without having to list each one, you can use <emphasis>range 1.64 @@ -332,7 +332,7 @@ 1.65 want all revisions between <literal>abc</literal> and 1.66 <literal>def</literal>, inclusive</quote>.</para> 1.67 1.68 - <!-- &interaction.tour.log.range; --> 1.69 + &interaction.tour.log.range; 1.70 1.71 <para>Mercurial also honours the order in which you specify 1.72 revisions, so <command role="hg-cmd">hg log -r 2:4</command> 1.73 @@ -353,7 +353,7 @@ 1.74 role="hg-opt-global">--verbose</option>) option gives you 1.75 this extra detail.</para> 1.76 1.77 - <!-- &interaction.tour.log-v; --> 1.78 + &interaction.tour.log-v; 1.79 1.80 <para>If you want to see both the description and content of a 1.81 change, add the <option role="hg-opt-log">-p</option> (or 1.82 @@ -363,7 +363,7 @@ 1.83 see section <xref linkend="sec:mq:patch"/> for an 1.84 overview).</para> 1.85 1.86 - <!-- &interaction.tour.log-vp; --> 1.87 + &interaction.tour.log-vp; 1.88 1.89 </sect2> 1.90 </sect1> 1.91 @@ -424,7 +424,7 @@ 1.92 than cloning over the network, and cloning a local repository 1.93 uses less disk space in most cases, too.</para> 1.94 1.95 - <!-- &interaction.tour.reclone; --> 1.96 + &interaction.tour.reclone; 1.97 1.98 <para>As an aside, it's often good practice to keep a 1.99 <quote>pristine</quote> copy of a remote repository around, 1.100 @@ -446,13 +446,13 @@ 1.101 <command>sed</command>; simply use your preferred text editor to 1.102 do the same thing.)</para> 1.103 1.104 - <!-- &interaction.tour.sed; --> 1.105 + &interaction.tour.sed; 1.106 1.107 <para>Mercurial's <command role="hg-cmd">hg status</command> 1.108 command will tell us what Mercurial knows about the files in the 1.109 repository.</para> 1.110 1.111 - <!-- &interaction.tour.status; --> 1.112 + &interaction.tour.status; 1.113 1.114 <para>The <command role="hg-cmd">hg status</command> command 1.115 prints no output for some files, but a line starting with 1.116 @@ -475,7 +475,7 @@ 1.117 do this, we use the <command role="hg-cmd">hg diff</command> 1.118 command.</para> 1.119 1.120 - <!-- &interaction.tour.diff; --> 1.121 + &interaction.tour.diff; 1.122 1.123 </sect1> 1.124 <sect1> 1.125 @@ -598,7 +598,7 @@ 1.126 printed by <command role="hg-cmd">hg log</command> after 1.127 we've finished committing.</para> 1.128 1.129 - <!-- &interaction.tour.commit; --> 1.130 + &interaction.tour.commit; 1.131 1.132 <para>The editor that the <command role="hg-cmd">hg 1.133 commit</command> command drops us into will contain an 1.134 @@ -665,7 +665,7 @@ 1.135 log</command>, but it only displays the newest revision in 1.136 the repository.</para> 1.137 1.138 - <!-- &interaction.tour.tip; --> 1.139 + &interaction.tour.tip; 1.140 1.141 <para>We refer to 1.142 the newest revision in the repository as the tip revision, 1.143 @@ -691,7 +691,7 @@ 1.144 call our temporary repository <filename 1.145 class="directory">hello-pull</filename>.</para> 1.146 1.147 - <!-- &interaction.tour.clone-pull; --> 1.148 + &interaction.tour.clone-pull; 1.149 1.150 <para>We'll use the <command role="hg-cmd">hg 1.151 pull</command> command to bring changes from <filename 1.152 @@ -704,7 +704,7 @@ 1.153 command <emphasis>would</emphasis> pull into the repository, 1.154 without actually pulling the changes in.</para> 1.155 1.156 - <!-- &interaction.tour.incoming; --> 1.157 + &interaction.tour.incoming; 1.158 1.159 <para>(Of course, someone could 1.160 cause more changesets to appear in the repository that we 1.161 @@ -718,7 +718,7 @@ 1.162 pull</command> command, and telling it which repository to 1.163 pull from.</para> 1.164 1.165 - <!-- &interaction.tour.pull; --> 1.166 + &interaction.tour.pull; 1.167 1.168 <para>As you can see 1.169 from the before-and-after output of <command 1.170 @@ -740,7 +740,7 @@ 1.171 the working directory. Instead, we use the <command 1.172 role="hg-cmd">hg update</command> command to do this.</para> 1.173 1.174 - <!-- &interaction.tour.update; --> 1.175 + &interaction.tour.update; 1.176 1.177 <para>It might seem a bit strange that <command role="hg-cmd">hg 1.178 pull</command> doesn't update the working directory 1.179 @@ -771,7 +771,7 @@ 1.180 the <command role="hg-cmd">hg parents</command> 1.181 command.</para> 1.182 1.183 - <!-- &interaction.tour.parents; --> 1.184 + &interaction.tour.parents; 1.185 1.186 <para>If you look back at figure <xref 1.187 linkend="fig:tour-basic:history"/>, 1.188 @@ -787,7 +787,7 @@ 1.189 give a revision number or changeset ID to the <command 1.190 role="hg-cmd">hg update</command> command.</para> 1.191 1.192 - <!-- &interaction.tour.older; --> 1.193 + &interaction.tour.older; 1.194 1.195 <para>If you omit an explicit revision, <command 1.196 role="hg-cmd">hg update</command> will update to the tip 1.197 @@ -805,19 +805,19 @@ 1.198 pull</command> above, we'll create a temporary repository 1.199 to push our changes into.</para> 1.200 1.201 - <!-- &interaction.tour.clone-push; --> 1.202 + &interaction.tour.clone-push; 1.203 1.204 <para>The <command role="hg-cmd">hg outgoing</command> command 1.205 tells us what changes would be pushed into another 1.206 repository.</para> 1.207 1.208 - <!-- &interaction.tour.outgoing; --> 1.209 + &interaction.tour.outgoing; 1.210 1.211 <para>And the 1.212 <command role="hg-cmd">hg push</command> command does the 1.213 actual push.</para> 1.214 1.215 - <!-- &interaction.tour.push; --> 1.216 + &interaction.tour.push; 1.217 1.218 <para>As with 1.219 <command role="hg-cmd">hg pull</command>, the <command 1.220 @@ -832,7 +832,7 @@ 1.221 and the receiving repository already has those changes? 1.222 Nothing too exciting.</para> 1.223 1.224 - <!-- &interaction.tour.push.nothing; --> 1.225 + &interaction.tour.push.nothing; 1.226 </sect2> 1.227 <sect2> 1.228 <title>Sharing changes over a network</title> 1.229 @@ -843,14 +843,14 @@ 1.230 connection; simply pass in a URL instead of a local 1.231 path.</para> 1.232 1.233 - <!-- &interaction.tour.outgoing.net; --> 1.234 + &interaction.tour.outgoing.net; 1.235 1.236 <para>In this example, we 1.237 can see what changes we could push to the remote repository, 1.238 but the repository is understandably not set up to let 1.239 anonymous users push to it.</para> 1.240 1.241 - <!-- &interaction.tour.push.net; --> 1.242 + &interaction.tour.push.net; 1.243 </sect2> 1.244 </sect1> 1.245 </chapter>