[svnbook] r4385 committed - Merge from ^/trunk/en r4384 (note 'format' and 'db/format' distinction...

[svnbook at googlecode.com]

Revision: 4385
Author:   cmpilato at gmail.com
Date:     Fri Feb  1 08:25:29 2013
Log:      Merge from ^/trunk/en r4384 (note 'format' and 'db/format'  
distinction).
http://code.google.com/p/svnbook/source/detail?r=4385

Modified:
  /branches/1.7/en
  /branches/1.7/en/book/ch05-repository-admin.xml

=======================================
--- /branches/1.7/en/book/ch05-repository-admin.xml	Tue Jan 29 11:01:10 2013
+++ /branches/1.7/en/book/ch05-repository-admin.xml	Fri Feb  1 08:25:29 2013
@@ -68,43 +68,55 @@

      <variablelist>
        <varlistentry>
-        <term>conf</term>
+        <term>conf/</term>
          <listitem>
-          <para>A directory containing configuration files</para>
+          <para>This directory is a container for configuration
+            files.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
-        <term>db</term>
+        <term>db/</term>
          <listitem>
-          <para>The data store for all of your versioned data</para>
+          <para>This directory contains the data store for all of your
+            versioned data.<footnote><para>Strictly speaking,
+            Subversion doesn't dictate that the versioned data live
+            here, and there are known (albeit proprietary) alternative
+            backend storage implementations which do not, in fact,
+            store data in this directory.</para></footnote></para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>format</term>
          <listitem>
-          <para>A file that describes the repository's internal
-            organizational scheme</para>
+          <para>This file describes the repository's internal
+            organizational scheme.  (As it turns out,
+            the <filename>db/</filename> subdirectory sometimes also
+            contains a <filename>format</filename> file which
+            describes only the contents of that subdirectory and which
+            is not to be confused with this file.)</para>
          </listitem>
        </varlistentry>
        <varlistentry>
-        <term>hooks</term>
+        <term>hooks/</term>
          <listitem>
-          <para>A directory full of hook script templates (and hook
-            scripts themselves, once you've installed some)</para>
+          <para>This directory contains hook script templates and
+            hook scripts, if any have been installed.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
-        <term>locks</term>
+        <term>locks/</term>
          <listitem>
-          <para>A directory for Subversion's repository lock
-            files, used for tracking accessors to the repository</para>
+          <para>Subversion uses this directory to house repository
+            lock files, used for managing concurrent access to the
+            repository.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>README.txt</term>
          <listitem>
-          <para>A file whose contents merely inform its readers that
-            they are looking at a Subversion repository</para>
+          <para>This is a brief text file containing merely a notice
+            to readers that the directory they are looking in is a
+            Subversion repository.</para>
          </listitem>
        </varlistentry>
      </variablelist>