[svnbook] r3784 committed - * src/en/book/ch06-server-configuration.xml...

[svnbook at googlecode.com]

Revision: 3784
Author: cmpilato at gmail.com
Date: Wed Sep 22 12:44:59 2010
Log: * src/en/book/ch06-server-configuration.xml
   Add a warning about the fact that SVNReposName is *not* the name
   that the authz subsystem uses.

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

Modified:
  /trunk/src/en/book/ch06-server-configuration.xml

=======================================
--- /trunk/src/en/book/ch06-server-configuration.xml	Mon Sep 13 12:17:34  
2010
+++ /trunk/src/en/book/ch06-server-configuration.xml	Wed Sep 22 12:44:59  
2010
@@ -3025,6 +3025,29 @@
        <literal>sally</literal> has read-only access.  Any other users
        are blocked from accessing this directory.</para>

+    <warning>
+      <para><command>mod_dav_svn</command> offers a directive,
+        <literal>SVNReposName</literal>, which allows administrators
+        to define a more human-friendly name, of sorts, for a
+        repository:</para>
+
+      <screen>
+<Location /svn/calc>
+  SVNPath /var/svn/calc
+  SVNReposName "Calculator Application"
+…
+</screen>
+
+      <para>This allows <command>mod_dav_svn</command> to identify the
+        repository by something other than merely its server directory
+        basename—<filename>calc</filename>, in the previous
+        example—when providing directory listings of repository
+        content.  Be aware, however, that when consulting the access
+        file for authorization rules, Subversion uses this repository
+        basename for comparison, <emphasis>not</emphasis> any
+        configured human-friendly name.</para>
+    </warning>
+
      <para>Of course, permissions are inherited from parent to child
        directory.  That means we can specify a subdirectory with a
        different access policy for Sally:</para>