[svnbook commit] r1889 - trunk/src/en/book

maxb svnbook-dev at red-bean.com
Thu Dec 8 15:31:08 CST 2005


Author: maxb
Date: Thu Dec  8 15:31:05 2005
New Revision: 1889

Modified:
   trunk/src/en/book/ch00.xml

Log:
* en/book/ch00.xml: Make use of <xref>-s where appropriate.


Modified: trunk/src/en/book/ch00.xml
==============================================================================
--- trunk/src/en/book/ch00.xml	(original)
+++ trunk/src/en/book/ch00.xml	Thu Dec  8 15:31:05 2005
@@ -106,11 +106,13 @@
         <listitem>
           <para>The assumption here is that you've probably used CVS
             before, and are dying to get a Subversion server up and
-            running ASAP.  Chapters 5 and 6 will show you how to create
+            running ASAP.  <xref linkend="svn.reposadmin"/> and <xref
+              linkend="svn.serverconfig"/> will show you how to create
             your first repository and make it available over the
-            network.  After that's done, chapter 3 and appendix A are
-            the fastest routes to learning the Subversion client while
-            drawing on your CVS experience.</para>
+            network.  After that's done, <xref linkend="svn.tour"/> and
+            <xref linkend="svn.forcvs"/> are the fastest routes to
+            learning the Subversion client while drawing on your CVS
+            experience.</para>
         </listitem>
       </varlistentry>
 
@@ -120,7 +122,8 @@
           <para>Your administrator has probably set up Subversion
             already, and you need to learn how to use the client.  If
             you've never used a version control system (like CVS),
-            then chapters 2 and 3 are a vital introduction.  If you're
+            then <xref linkend="svn.basic"/> and <xref
+              linkend="svn.tour"/> are a vital introduction.  If you're
             already an old hand at CVS, chapter 3 and appendix A are
             the best place to start.</para>
         </listitem>
@@ -132,11 +135,12 @@
           <para>Whether you're a user or administrator, eventually
             your project will grow larger.  You're going to want to
             learn how to do more advanced things with Subversion, such
-            as how to use branches and perform merges (chapter 4),
-            how to use Subversion's property support, how to configure
-            runtime options (chapter 7), and other things.  Chapters 4
-            and 7 aren't vital at first, but be sure to read them once
-            you're comfortable with the basics.</para>
+            as how to use branches and perform merges (<xref
+              linkend="svn.branchmerge"/>), how to use Subversion's
+            property support, how to configure runtime options (<xref
+              linkend="svn.advanced"/>), and other things.  These two
+            chapters aren't vital at first, but be sure to read them
+            once you're comfortable with the basics.</para>
         </listitem>
       </varlistentry>
 
@@ -145,16 +149,17 @@
         <listitem>
           <para>Presumably, you're already familiar with Subversion,
             and now want to either extend it or build new software on
-            top of its many APIs.  Chapter 8 is just for you.</para>
+            top of its many APIs.  <xref linkend="svn.developer"/> is
+            just for you.</para>
         </listitem>
       </varlistentry>
     </variablelist>
 
-    <para>The book ends with reference material—chapter 9 is a
-      reference guide for all Subversion commands, and the appendices
-      cover a number of useful topics.  These are the chapters you're
-      mostly likely to come back to after you've finished the
-      book.</para>
+    <para>The book ends with reference material—<xref
+        linkend="svn.ref"/> is a reference guide for all Subversion
+      commands, and the appendices cover a number of useful topics.
+      These are the chapters you're mostly likely to come back to after
+      you've finished the book.</para>
 
   </sect1>
 
@@ -238,7 +243,7 @@
       <variablelist>
         
         <varlistentry>
-          <term>Chapter 1, <emphasis>Introduction</emphasis></term>
+          <term><xref linkend="svn.intro"/></term>
           <listitem>
             <para>Covers the history of Subversion as well as its
               features, architecture, components, and install
@@ -247,7 +252,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 2, <emphasis>Basic Concepts</emphasis></term>
+          <term><xref linkend="svn.basic"/></term>
           <listitem>
             <para>Explains the basics of version control and different
               versioning models, along with Subversion's repository,
@@ -256,7 +261,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 3, <emphasis>Guided Tour</emphasis></term>
+          <term><xref linkend="svn.tour"/></term>
           <listitem>
             <para>Walks you through a day in the life of a Subversion
               user.  It demonstrates how to use Subversion to obtain,
@@ -265,7 +270,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 4, <emphasis>Branching and Merging</emphasis></term>
+          <term><xref linkend="svn.branchmerge"/></term>
           <listitem>
             <para>Discusses branches, merges, and tagging, including
               best practices for branching and merging, common
@@ -275,8 +280,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 5, <emphasis>Repository
-            Administration</emphasis></term>
+          <term><xref linkend="svn.reposadmin"/></term>
           <listitem>
             <para>Describes the basics of the Subversion repository,
               how to create, configure, and maintain a repository, and
@@ -285,7 +289,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 6, <emphasis>Server Configuration</emphasis></term>
+          <term><xref linkend="svn.serverconfig"/></term>
           <listitem>
             <para>Explains how to configure your Subversion server and
               the three ways to access your repository:
@@ -297,7 +301,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 7, <emphasis>Advanced Topics</emphasis></term>
+          <term><xref linkend="svn.advanced"/></term>
           <listitem>
             <para>Explores the Subversion client configuration files,
               file and directory properties, how to
@@ -308,7 +312,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 8, <emphasis>Developer Information</emphasis></term>
+          <term><xref linkend="svn.developer"/></term>
           <listitem>
             <para>Describes the internals of Subversion, the
               Subversion filesystem, and the working copy
@@ -320,8 +324,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Chapter 9, <emphasis>Subversion Complete
-            Reference</emphasis></term>
+          <term><xref linkend="svn.ref"/></term>
           <listitem>
             <para>Explains in great detail every subcommand of
               <command>svn</command>, <command>svnadmin</command>, and
@@ -331,8 +334,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Appendix A, <emphasis>Subversion for CVS
-            Users</emphasis></term>
+          <term><xref linkend="svn.forcvs"/></term>
           <listitem>
             <para>Covers the similarities and differences between
               Subversion and CVS, with numerous suggestions on how to
@@ -346,8 +348,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Appendix B, <emphasis>WebDAV and
-            Autoversioning</emphasis></term>
+          <term><xref linkend="svn.webdav"/></term>
           <listitem>
             <para>Describes the details of WebDAV and DeltaV, and how
               you can configure your Subversion repository to be
@@ -356,7 +357,7 @@
         </varlistentry>
 
         <varlistentry>
-          <term>Appendix C, <emphasis>Third Party Tools</emphasis></term>
+          <term><xref linkend="svn.3rdparty"/></term>
           <listitem>
             <para>Discusses tools that support or use Subversion,
               including alternative client programs, repository




More information about the svnbook-dev mailing list