[svnbook] r4457 committed - * en/book/ch01-fundamental-concepts.xml...

[svnbook at googlecode.com]

Revision: 4457
Author:   cmpilato at gmail.com
Date:     Wed Mar 20 06:48:28 2013
Log:      * en/book/ch01-fundamental-concepts.xml
   Introduce the term "repository-relative URL", and add some Index
   magic for it.

http://code.google.com/p/svnbook/source/detail?r=4457

Modified:
  /trunk/en/book/ch01-fundamental-concepts.xml

=======================================
--- /trunk/en/book/ch01-fundamental-concepts.xml	Fri Feb  8 10:32:43 2013
+++ /trunk/en/book/ch01-fundamental-concepts.xml	Wed Mar 20 06:48:28 2013
@@ -626,18 +626,30 @@
          <xref linkend="svn.advanced.pegrevs" />—in order to make
          Subversion properly address that resource.</para>

-      <para>In Subversion 1.6, a new caret (<literal>^</literal>)
+      <para>
+        <indexterm>
+          <primary>repository-relative URL</primary>
+        </indexterm>
+        <indexterm>
+          <primary>caret syntax</primary>
+        </indexterm>
+        <indexterm>
+          <primary>^</primary>
+          <see>caret syntax</see>
+        </indexterm>In Subversion 1.6, a new caret (<literal>^</literal>)
          notation was introduced as a shorthand for <quote>the URL of
          the repository's root directory</quote>.  For example, you can
          use the <literal>^/tags/bigsandwich/</literal> to refer to the
          URL of the <filename>/tags/bigsandwich</filename> directory in
-        the root of the repository.  Note that this URL syntax works
-        only when your current working directory is a working
-        copy—the command-line client knows the repository's root
-        URL by looking at the working copy's metadata.  Also note that
-        when you wish to refer precisely to the root directory of the
-        repository, you must do so using <literal>^/</literal> (with
-        the trailing slash character), not merely
+        the root of the repository.  Such a URL is called a
+        <firstterm>repository-relative URL</firstterm>.  Note
+        that this URL syntax works only when your current working
+        directory is a working copy—the command-line client
+        knows the repository's root URL by looking at the working
+        copy's metadata.  Also note that when you wish to refer
+        precisely to the root directory of the repository, you must do
+        so using <literal>^/</literal> (with the trailing slash
+        character), not merely
          <literal>^</literal>.</para>

      </sect2>