[PATCH] Document svnserve path-based write authn capability

On both users@ and irc, the question keeps popping up if it's possible to
use path based auth with svnserve. I decided that the book needs a section
about it. My current patch is a bit marginal, but it might be a nice start.

Also, the book might need a glossary to contrib/ and tools/ so that people
get pointed to usefull tools such as svnmerge.

Anyway, do with it what you like.

Patch description:

Since there already was a section about built-in auth capabilities for
svnserve, I added a section on the same level which documents the existence
of external authn. Adding this section required for one section to be
renumbered and one link to be renamed.

bye,

Erik.

Index: doc/book/book/ch06.xml
===================================================================
--- doc/book/book/ch06.xml (revision 11651)
+++ doc/book/book/ch06.xml (working copy)
@@ -93,7 +93,9 @@
             <entry>blanket read/write access, or per-directory access
               control</entry>
              
- <entry>blanket read/write access</entry>
+ <entry>blanket read/write access, or per-directory write access
+ control using hook scripts (see the svnperms.py hook script
+ in the Subversion distribution for an example)</entry>
           </row>
            
           <row>
@@ -691,8 +693,20 @@
       </sect3>
  
     </sect2>
-
+
+
     <sect2 id="svn-ch-6-sect-3.3">
+ <title>External path-based authorisation</title>
+
+ <para>While <command>svnserve</command> does not provide any means to
+ control per-path authorisation, a pre-commit hook can be used to
+ enforce per-path write access control. The Subversion distribution
+ comes with <command>commit-access-control.pl</command> and the more
+ sophisticated <command>svnperms.py</command> scripts for use in
+ pre-commit scripts.</para>
+ </sect2>
+
+ <sect2 id="svn-ch-6-sect-3.4">
       <title>SSH authentication and authorization</title>
  
       <para><command>svnserve</command>'s built-in authentication can
Index: doc/book/book/ch07.xml
===================================================================
--- doc/book/book/ch07.xml (revision 11651)
+++ doc/book/book/ch07.xml (working copy)
@@ -532,7 +532,7 @@
           define new tunnel schemes for use with
           <command>svnserve</command> and <literal>svn://</literal>
           client connections. For more details, see <xref
- linkend="svn-ch-6-sect-3.3"/>.</para>
+ linkend="svn-ch-6-sect-3.4"/>.</para>
  
         <para>The <literal>miscellany</literal> section is where
           everything that doesn't belong elsewhere winds up.

-- 
NEU +++ DSL Komplett von GMX +++ http://www.gmx.net/de/go/dsl
GMX DSL-Netzanschluss + Tarif zum supergünstigen Komplett-Preis!
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org