hgbook

changeset 676:29f0f79cf614

Update paragraph IDs
author Bryan O'Sullivan <bos@serpentine.com>
date Thu Apr 16 23:46:45 2009 -0700 (2009-04-16)
parents e6c99cbd0abd
children 743dc55775fe 8613844dd2cf
files en/ch01-tour-basic.xml en/ch02-tour-merge.xml en/ch03-concepts.xml en/ch04-daily.xml en/ch05-collab.xml en/ch06-filenames.xml
line diff
     1.1 --- a/en/ch01-tour-basic.xml	Thu Apr 16 23:45:07 2009 -0700
     1.2 +++ b/en/ch01-tour-basic.xml	Thu Apr 16 23:46:45 2009 -0700
     1.3 @@ -131,7 +131,7 @@
     1.4  
     1.5        &interaction.tour.clone;
     1.6  
     1.7 -      <para>One advantage of using <command role="hg-cmd">hg
     1.8 +      <para id="x_67c">One advantage of using <command role="hg-cmd">hg
     1.9  	  clone</command> is that, as we can see above, it lets us clone
    1.10  	repositories over the network.  Another is that it remembers
    1.11  	where we cloned from, which we'll find useful soon when we
    1.12 @@ -233,7 +233,7 @@
    1.13  	  the text message that the creator of the changeset entered
    1.14  	  to describe the changeset.</para></listitem>
    1.15        <listitem>
    1.16 -	<para>Some changesets, such as the first in the list above,
    1.17 +	<para id="x_67d">Some changesets, such as the first in the list above,
    1.18  	  have a <literal>tag</literal> field.  A tag is another way
    1.19  	  to identify a changeset, by giving it an easy-to-remember
    1.20  	  name. (The tag named <literal>tip</literal> is special: it
    1.21 @@ -364,7 +364,7 @@
    1.22  
    1.23        &interaction.tour.log-vp;
    1.24  
    1.25 -      <para>The <option role="hg-opt-log">-p</option> option is
    1.26 +      <para id="x_67e">The <option role="hg-opt-log">-p</option> option is
    1.27  	tremendously useful, so it's well worth remembering.</para>
    1.28  
    1.29      </sect2>
    1.30 @@ -410,7 +410,7 @@
    1.31  	    role="hg-opt-log">--rev</option> arguments.</para>
    1.32        </listitem>
    1.33        <listitem>
    1.34 -	<para>If you are using short options, you can save typing by
    1.35 +	<para id="x_67f">If you are using short options, you can save typing by
    1.36  	  running them together. For example, the command <command
    1.37  	    role="hg-cmd">hg log -v -p -r 2</command> can be written
    1.38  	  as <command role="hg-cmd">hg log -vpr2</command>.</para>
    1.39 @@ -430,7 +430,7 @@
    1.40      <note>
    1.41        <title>Option naming consistency</title>
    1.42  
    1.43 -      <para>Almost always, Mercurial commands use consistent option
    1.44 +      <para id="x_680">Almost always, Mercurial commands use consistent option
    1.45  	names to refer to the same concepts.  For instance, if a
    1.46  	command deals with changesets, you'll always identify them
    1.47  	with <option role="hg-opt-log">--rev</option> or <option
    1.48 @@ -454,7 +454,7 @@
    1.49        locally, we can just clone that instead.  This is much faster
    1.50        than cloning over the network, and cloning a local repository
    1.51        uses less disk space in most cases, too<footnote>
    1.52 -	<para>The saving of space arises when source and destination
    1.53 +	<para id="x_681">The saving of space arises when source and destination
    1.54  	  repositories are on the same filesystem, in which case
    1.55  	  Mercurial will use hardlinks to do copy-on-write sharing of
    1.56  	  its internal metadata.  If that explanation meant nothing to
    1.57 @@ -479,7 +479,7 @@
    1.58  
    1.59      &interaction.tour.cat1;
    1.60  
    1.61 -    <para>Let's edit this file so that it prints a second line of
    1.62 +    <para id="x_682">Let's edit this file so that it prints a second line of
    1.63        output.</para>
    1.64  
    1.65      &interaction.tour.cat2;
    1.66 @@ -516,7 +516,7 @@
    1.67      <tip>
    1.68        <title>Understanding patches</title>
    1.69  
    1.70 -      <para>Remember to take a look at <xref
    1.71 +      <para id="x_683">Remember to take a look at <xref
    1.72  	  linkend="sec:mq:patch"/> if you don't know how to read
    1.73  	output above.</para>
    1.74      </tip>
    1.75 @@ -726,7 +726,7 @@
    1.76  	repository as the <emphasis>tip revision</emphasis>, or simply
    1.77  	the <emphasis>tip</emphasis>.</para>
    1.78  
    1.79 -      <para>By the way, the <command role="hg-cmd">hg tip</command>
    1.80 +      <para id="x_684">By the way, the <command role="hg-cmd">hg tip</command>
    1.81  	command accepts many of the same options as <command
    1.82  	  role="hg-cmd">hg log</command>, so <option
    1.83  	  role="hg-opt-global">-v</option> above indicates <quote>be
     2.1 --- a/en/ch02-tour-merge.xml	Thu Apr 16 23:45:07 2009 -0700
     2.2 +++ b/en/ch02-tour-merge.xml	Thu Apr 16 23:46:45 2009 -0700
     2.3 @@ -164,7 +164,7 @@
     2.4  	</mediaobject>
     2.5        </figure>
     2.6  
     2.7 -      <para>We sometimes talk about a merge having
     2.8 +      <para id="x_69c">We sometimes talk about a merge having
     2.9  	<emphasis>sides</emphasis>: the left side is the first parent
    2.10  	in the output of <command role="hg-cmd">hg parents</command>,
    2.11  	and the right side is the second.  If the working directory
     3.1 --- a/en/ch03-concepts.xml	Thu Apr 16 23:45:07 2009 -0700
     3.2 +++ b/en/ch03-concepts.xml	Thu Apr 16 23:46:45 2009 -0700
     3.3 @@ -524,13 +524,13 @@
     3.4      <sect2>
     3.5        <title>Merging and renames</title>
     3.6  
     3.7 -      <para>A surprising number of revision control systems pay little
     3.8 +      <para id="x_69a">A surprising number of revision control systems pay little
     3.9  	or no attention to a file's <emphasis>name</emphasis> over
    3.10  	time.  For instance, it used to be common that if a file got
    3.11  	renamed on one side of a merge, the changes from the other
    3.12  	side would be silently dropped.</para>
    3.13  
    3.14 -      <para>Mercurial records metadata when you tell it to perform a
    3.15 +      <para id="x_69b">Mercurial records metadata when you tell it to perform a
    3.16  	rename or copy. It uses this metadata during a merge to do the
    3.17  	right thing in the case of a merge.  For instance, if I rename
    3.18  	a file, and you edit it without renaming it, when we merge our
     4.1 --- a/en/ch04-daily.xml	Thu Apr 16 23:45:07 2009 -0700
     4.2 +++ b/en/ch04-daily.xml	Thu Apr 16 23:46:45 2009 -0700
     4.3 @@ -357,7 +357,7 @@
     4.4  	<emphasis>destination</emphasis>, and all others are
     4.5  	<emphasis>sources</emphasis>.</para>
     4.6  
     4.7 -      <para>If you pass <command role="hg-cmd">hg copy</command> a
     4.8 +      <para id="x_685">If you pass <command role="hg-cmd">hg copy</command> a
     4.9  	single file as the source, and the destination does not exist,
    4.10  	it creates a new file with that name.</para>
    4.11  
    4.12 @@ -430,7 +430,7 @@
    4.13        similar to the <command role="hg-cmd">hg copy</command>
    4.14        command.</para>
    4.15  
    4.16 -    <para>If you're familiar with the Unix command line, you'll be
    4.17 +    <para id="x_686">If you're familiar with the Unix command line, you'll be
    4.18        glad to know that <command role="hg-cmd">hg rename</command>
    4.19        command can be invoked as <command role="hg-cmd">hg
    4.20  	mv</command>.</para>
    4.21 @@ -550,37 +550,37 @@
    4.22    <sect1>
    4.23      <title>Dealing with tricky merges</title>
    4.24  
    4.25 -    <para>In a complicated or large project, it's not unusual for a
    4.26 +    <para id="x_687">In a complicated or large project, it's not unusual for a
    4.27        merge of two changesets to result in some headaches.  Suppose
    4.28        there's a big source file that's been extensively edited by each
    4.29        side of a merge: this is almost inevitably going to result in
    4.30        conflicts, some of which can take a few tries to sort
    4.31        out.</para>
    4.32  
    4.33 -    <para>Let's develop a simple case of this and see how to deal with
    4.34 +    <para id="x_688">Let's develop a simple case of this and see how to deal with
    4.35        it.  We'll start off with a repository containing one file, and
    4.36        clone it twice.</para>
    4.37  
    4.38      &interaction.ch04-resolve.init;
    4.39  
    4.40 -    <para>In one clone, we'll modify the file in one way.</para>
    4.41 +    <para id="x_689">In one clone, we'll modify the file in one way.</para>
    4.42  
    4.43      &interaction.ch04-resolve.left;
    4.44  
    4.45 -    <para>In another, we'll modify the file differently.</para>
    4.46 +    <para id="x_68a">In another, we'll modify the file differently.</para>
    4.47  
    4.48      &interaction.ch04-resolve.right;
    4.49  
    4.50 -    <para>Next, we'll pull each set of changes into our original
    4.51 +    <para id="x_68b">Next, we'll pull each set of changes into our original
    4.52        repo.</para>
    4.53  
    4.54      &interaction.ch04-resolve.pull;
    4.55  
    4.56 -    <para>We expect our repository to now contain two heads.</para>
    4.57 +    <para id="x_68c">We expect our repository to now contain two heads.</para>
    4.58  
    4.59      &interaction.ch04-resolve.heads;
    4.60  
    4.61 -    <para>Normally, if we run <command role="hg-cmd">hg
    4.62 +    <para id="x_68d">Normally, if we run <command role="hg-cmd">hg
    4.63  	merge</command> at this point, it will drop us into a GUI that
    4.64        will let us manually resolve the conflicting edits to
    4.65        <filename>myfile.txt</filename>.  However, to simplify things
    4.66 @@ -589,24 +589,24 @@
    4.67  
    4.68      &interaction.ch04-resolve.export;
    4.69  
    4.70 -    <para>We've told Mercurial's merge machinery to run the command
    4.71 +    <para id="x_68e">We've told Mercurial's merge machinery to run the command
    4.72        <command>false</command> (which, as we desire, fails
    4.73        immediately) if it detects a merge that it can't sort out
    4.74        automatically.</para>
    4.75  
    4.76 -    <para>If we now fire up <command role="hg-cmd">hg
    4.77 +    <para id="x_68f">If we now fire up <command role="hg-cmd">hg
    4.78  	merge</command>, it should grind to a halt and report a
    4.79  	failure.</para>
    4.80  
    4.81      &interaction.ch04-resolve.merge;
    4.82  
    4.83 -    <para>Even if we don't notice that the merge failed, Mercurial
    4.84 +    <para id="x_690">Even if we don't notice that the merge failed, Mercurial
    4.85        will prevent us from accidentally committing the result of a
    4.86        failed merge.</para>
    4.87  
    4.88      &interaction.ch04-resolve.cifail;
    4.89  
    4.90 -    <para>When <command role="hg-cmd">hg commit</command> fails in
    4.91 +    <para id="x_691">When <command role="hg-cmd">hg commit</command> fails in
    4.92        this case, it suggests that we use the unfamiliar <command
    4.93  	role="hg-cmd">hg resolve</command> command.  As usual,
    4.94  	<command role="hg-cmd">hg help resolve</command> will print a
    4.95 @@ -615,35 +615,35 @@
    4.96      <sect2>
    4.97        <title>File resolution states</title>
    4.98  
    4.99 -      <para>When a merge occurs, most files will usually remain
   4.100 +      <para id="x_692">When a merge occurs, most files will usually remain
   4.101  	unmodified.  For each file where Mercurial has to do
   4.102  	something, it tracks the state of the file.</para>
   4.103  
   4.104        <itemizedlist>
   4.105  	<listitem>
   4.106 -	  <para>A <emphasis>resolved</emphasis> file has been
   4.107 +	  <para id="x_693">A <emphasis>resolved</emphasis> file has been
   4.108  	    successfully merged, either automatically by Mercurial or
   4.109  	    manually with human intervention.</para>
   4.110  	</listitem>
   4.111  	<listitem>
   4.112 -	  <para>An <emphasis>unresolved</emphasis> file was not merged
   4.113 +	  <para id="x_694">An <emphasis>unresolved</emphasis> file was not merged
   4.114  	    successfully, and needs more attention.</para>
   4.115  	</listitem>
   4.116        </itemizedlist>
   4.117  
   4.118 -      <para>If Mercurial sees <emphasis>any</emphasis> file in the
   4.119 +      <para id="x_695">If Mercurial sees <emphasis>any</emphasis> file in the
   4.120  	unresolved state after a merge, it considers the merge to have
   4.121  	failed.  Fortunately, we do not need to restart the entire
   4.122  	merge from scratch.</para>
   4.123  
   4.124 -      <para>The <option role="hg-opt-resolve">--list</option> or
   4.125 +      <para id="x_696">The <option role="hg-opt-resolve">--list</option> or
   4.126  	<option role="hg-opt-resolve">-l</option> option to <command
   4.127  	  role="hg-cmd">hg resolve</command> prints out the state of
   4.128  	each merged file.</para>
   4.129  
   4.130        &interaction.ch04-resolve.list;
   4.131  
   4.132 -      <para>In the output from <command role="hg-cmd">hg
   4.133 +      <para id="x_697">In the output from <command role="hg-cmd">hg
   4.134  	  resolve</command>, a resolved file is marked with
   4.135  	<literal>R</literal>, while an unresolved file is marked with
   4.136  	<literal>U</literal>.  If any files are listed with
   4.137 @@ -654,7 +654,7 @@
   4.138      <sect2>
   4.139        <title>Resolving a file merge</title>
   4.140  
   4.141 -      <para>We have several options to move a file from the unresolved
   4.142 +      <para id="x_698">We have several options to move a file from the unresolved
   4.143  	into the resolved state.  By far the most common is to rerun
   4.144  	<command role="hg-cmd">hg resolve</command>.  If we pass the
   4.145  	names of individual files or directories, it will retry the
   4.146 @@ -664,7 +664,7 @@
   4.147  	will retry the merges of <emphasis>all</emphasis> unresolved
   4.148  	files.</para>
   4.149  
   4.150 -      <para>Mercurial also lets us modify the resolution state of a
   4.151 +      <para id="x_699">Mercurial also lets us modify the resolution state of a
   4.152  	file directly.  We can manually mark a file as resolved using
   4.153  	the <option role="hg-opt-resolve">--mark</option> option, or
   4.154  	as unresolved using the <option
     5.1 --- a/en/ch05-collab.xml	Thu Apr 16 23:45:07 2009 -0700
     5.2 +++ b/en/ch05-collab.xml	Thu Apr 16 23:46:45 2009 -0700
     5.3 @@ -48,27 +48,27 @@
     5.4        to your own repositories, there are several good ways to do
     5.5        this.</para>
     5.6  
     5.7 -    <para>The easiest and fastest way to get started in an informal
     5.8 +    <para id="x_69d">The easiest and fastest way to get started in an informal
     5.9        environment is to use the <command role="hg-cmd">hg
    5.10  	serve</command> command, which is best suited to short-term
    5.11        <quote>lightweight</quote> serving.  See <xref
    5.12  	linkend="sec:collab:serve"/> below for details of how to use
    5.13        this command.</para>
    5.14  
    5.15 -    <para>For longer-lived repositories that you'd like to have
    5.16 +    <para id="x_69e">For longer-lived repositories that you'd like to have
    5.17        permanently available, there are several public hosting services
    5.18        available.</para>
    5.19  
    5.20      <itemizedlist>
    5.21        <listitem>
    5.22 -	<para>Bitbucket, at <ulink
    5.23 +	<para id="x_69f">Bitbucket, at <ulink
    5.24  	    url="http://bitbucket.org/">http://bitbucket.org/</ulink>,
    5.25  	  provides free hosting for open source projects, and paid
    5.26  	  hosting for commercial projects.</para>
    5.27        </listitem>
    5.28      </itemizedlist>
    5.29  
    5.30 -    <para>If you would prefer to host your own repositories, Mercurial
    5.31 +    <para id="x_6a0">If you would prefer to host your own repositories, Mercurial
    5.32        has built-in support for several popular hosting technologies,
    5.33        most notably CGI (Common Gateway Interface), and WSGI (Web
    5.34        Services Gateway Interface).  See <xref
    5.35 @@ -198,19 +198,19 @@
    5.36      <sect2>
    5.37        <title>A hosted central repository</title>
    5.38  
    5.39 -      <para>A wonderful thing about public hosting services like
    5.40 +      <para id="x_6a1">A wonderful thing about public hosting services like
    5.41  	<ulink url="http://bitbucket.org/">Bitbucket</ulink> is that
    5.42  	not only do they handle the fiddly server configuration
    5.43  	details, such as user accounts, authentication, and secure
    5.44  	wire protocols, they provide additional infrastructure to make
    5.45  	this model work well.</para>
    5.46  
    5.47 -      <para>For instance, a well-engineered hosting service will let
    5.48 +      <para id="x_6a2">For instance, a well-engineered hosting service will let
    5.49  	people clone their own copies of a repository with a single
    5.50  	click.  This lets people work in separate spaces and share
    5.51  	their changes when they're ready.</para>
    5.52  
    5.53 -      <para>In addition, a good hosting service will let people
    5.54 +      <para id="x_6a3">In addition, a good hosting service will let people
    5.55  	communicate with each other, for instance to say <quote>there
    5.56  	  are changes ready for you to review in this
    5.57  	  tree</quote>.</para>
    5.58 @@ -643,7 +643,7 @@
    5.59        <tip>
    5.60  	<title>Key pairs are not mandatory</title>
    5.61  
    5.62 -	<para>Mercurial knows nothing about ssh authentication or key
    5.63 +	<para id="x_6a4">Mercurial knows nothing about ssh authentication or key
    5.64  	  pairs.  You can, if you like, safely ignore this section and
    5.65  	  the one that follows until you grow tired of repeatedly
    5.66  	  typing ssh passwords.</para>
    5.67 @@ -651,10 +651,10 @@
    5.68  
    5.69        <itemizedlist>
    5.70  	<listitem>
    5.71 -	  <para>On a Unix-like system, the
    5.72 +	  <para id="x_6a5">On a Unix-like system, the
    5.73  	    <command>ssh-keygen</command> command will do the
    5.74  	    trick.</para>
    5.75 -	  <para>On Windows, if you're using TortoiseHg, you may need
    5.76 +	  <para id="x_6a6">On Windows, if you're using TortoiseHg, you may need
    5.77  	    to download a command named <command>puttygen</command>
    5.78  	    from <ulink
    5.79  	      url="http://www.chiark.greenend.org.uk/~sgtatham/putty">the 
    5.80 @@ -716,7 +716,7 @@
    5.81  	    to the agent's store.</para>
    5.82  	</listitem>
    5.83  	<listitem>
    5.84 -	  <para>On Windows, if you're using TortoiseHg, the
    5.85 +	  <para id="x_6a7">On Windows, if you're using TortoiseHg, the
    5.86  	    <command>pageant</command> command acts as the agent.  As
    5.87  	    with <command>puttygen</command>, you'll need to <ulink
    5.88  	      url="http://www.chiark.greenend.org.uk/%7Esgtatham/putty/download.html">download 
    5.89 @@ -928,7 +928,7 @@
    5.90    <sect1 id="sec:collab:cgi">
    5.91      <title>Serving over HTTP using CGI</title>
    5.92  
    5.93 -    <para>The simplest way to host one or more repositories in a
    5.94 +    <para id="x_6a8">The simplest way to host one or more repositories in a
    5.95        permanent way is to use a web server and Mercurial's CGI
    5.96        support.</para>
    5.97  
    5.98 @@ -952,7 +952,7 @@
    5.99  	plenty of mistakes, and to spend a lot of time reading your
   5.100  	server's error logs.</para>
   5.101  
   5.102 -      <para>If you don't have a strong stomach for tweaking
   5.103 +      <para id="x_6a9">If you don't have a strong stomach for tweaking
   5.104  	configurations over and over, or a compelling need to host
   5.105  	your own services, you might want to try one of the public
   5.106  	hosting services that I mentioned earlier.</para>
   5.107 @@ -1394,25 +1394,25 @@
   5.108  	    ships with several web templates.</para>
   5.109  	  <itemizedlist>
   5.110  	    <listitem>
   5.111 -	      <para><literal>coal</literal> is monochromatic.</para>
   5.112 +	      <para id="x_6aa"><literal>coal</literal> is monochromatic.</para>
   5.113  	    </listitem>
   5.114  	    <listitem>
   5.115 -	      <para><literal>gitweb</literal> emulates the visual
   5.116 +	      <para id="x_6ab"><literal>gitweb</literal> emulates the visual
   5.117  		style of git's web interface.</para>
   5.118  	    </listitem>
   5.119  	    <listitem>
   5.120 -	      <para><literal>monoblue</literal> uses solid blues and
   5.121 +	      <para id="x_6ac"><literal>monoblue</literal> uses solid blues and
   5.122  		greys.</para>
   5.123  	    </listitem>
   5.124  	    <listitem>
   5.125 -	      <para><literal>paper</literal> is the default.</para>
   5.126 +	      <para id="x_6ad"><literal>paper</literal> is the default.</para>
   5.127  	    </listitem>
   5.128  	    <listitem>
   5.129 -	      <para><literal>spartan</literal> was the default for a
   5.130 +	      <para id="x_6ae"><literal>spartan</literal> was the default for a
   5.131  		long time.</para>
   5.132  	    </listitem>
   5.133  	  </itemizedlist>
   5.134 -	  <para>You can
   5.135 +	  <para id="x_6af">You can
   5.136  	    also specify a custom template of your own; see 
   5.137  	    <xref linkend="chap:template"/> for details. Here, you can
   5.138  	    see how to enable the <literal>gitweb</literal>
   5.139 @@ -1523,12 +1523,12 @@
   5.140    <sect1>
   5.141      <title>System-wide configuration</title>
   5.142  
   5.143 -    <para>On Unix-like systems shared by multiple users (such as a
   5.144 +    <para id="x_6b0">On Unix-like systems shared by multiple users (such as a
   5.145        server to which people publish changes), it often makes sense to
   5.146        set up some global default behaviors, such as what theme to use
   5.147        in web interfaces.</para>
   5.148  
   5.149 -    <para>If a file named <filename>/etc/mercurial/hgrc</filename>
   5.150 +    <para id="x_6b1">If a file named <filename>/etc/mercurial/hgrc</filename>
   5.151        exists, Mercurial will read it at startup time and apply any
   5.152        configuration settings it finds in that file.  It will also look
   5.153        for files ending in a <literal>.rc</literal> extension in a
   5.154 @@ -1539,7 +1539,7 @@
   5.155      <sect2>
   5.156        <title>Making Mercurial more trusting</title>
   5.157  
   5.158 -      <para>One situation in which a global <filename>hgrc</filename>
   5.159 +      <para id="x_6b2">One situation in which a global <filename>hgrc</filename>
   5.160  	can be useful is if users are pulling changes owned by other
   5.161  	users.  By default, Mercurial will not trust most of the
   5.162  	configuration items in a <filename>.hg/hgrc</filename> file
   5.163 @@ -1548,7 +1548,7 @@
   5.164  	print a warning stating that it does not trust their
   5.165  	<filename>.hg/hgrc</filename>.</para>
   5.166  
   5.167 -      <para>If everyone in a particular Unix group is on the same team
   5.168 +      <para id="x_6b3">If everyone in a particular Unix group is on the same team
   5.169  	and <emphasis>should</emphasis> trust each other's
   5.170  	configuration settings, or we want to trust particular users,
   5.171  	we can override Mercurial's skeptical defaults by creating a
     6.1 --- a/en/ch06-filenames.xml	Thu Apr 16 23:45:07 2009 -0700
     6.2 +++ b/en/ch06-filenames.xml	Thu Apr 16 23:46:45 2009 -0700
     6.3 @@ -283,14 +283,14 @@
     6.4        directory with lock files, temporary working files, and backup
     6.5        files, which it also makes no sense to manage.</para>
     6.6  
     6.7 -    <para>To have Mercurial permanently ignore such files, create a
     6.8 +    <para id="x_6b4">To have Mercurial permanently ignore such files, create a
     6.9        file named <filename>.hgignore</filename> in the root of your
    6.10        repository.  You <emphasis>should</emphasis> <command>hg
    6.11        add</command> this file so that it gets tracked with the rest of
    6.12        your repository contents, since your collaborators will probably
    6.13        find it useful too.</para>
    6.14  
    6.15 -    <para>By default, the <filename>.hgignore</filename> file should
    6.16 +    <para id="x_6b5">By default, the <filename>.hgignore</filename> file should
    6.17        contain a list of regular expressions, one per line.  Empty
    6.18        lines are skipped. Most people prefer to describe the files they
    6.19        want to ignore using the <quote>glob</quote> syntax that we
    6.20 @@ -299,10 +299,10 @@
    6.21  
    6.22      <programlisting>syntax: glob</programlisting>
    6.23  
    6.24 -    <para>This tells Mercurial to interpret the lines that follow as
    6.25 +    <para id="x_6b6">This tells Mercurial to interpret the lines that follow as
    6.26        glob patterns, not regular expressions.</para>
    6.27  
    6.28 -    <para>Here is a typical-looking <filename>.hgignore</filename>
    6.29 +    <para id="x_6b7">Here is a typical-looking <filename>.hgignore</filename>
    6.30        file.</para>
    6.31  
    6.32      <programlisting>syntax: glob