[svnbook] r4401 committed - After failing for years to be satisfied with the inconsistent layout...

svnbook at googlecode.com svnbook at googlecode.com
Wed Feb 6 11:33:33 CST 2013


Revision: 4401
Author:   cmpilato at gmail.com
Date:     Wed Feb  6 09:33:02 2013
Log:      After failing for years to be satisfied with the inconsistent  
layout
of the reference section, admit some defeat and move httpd.conf
configuration and Subversion property stuffs -- which were never
anything close to "complete reference" quality anyway -- back into the
main portion of the book, leaving the reference material to strictly
cover *commands* (as a Reference is intended to do).

* en/book/book.xml
   Drop unnecessary entity references and usages.  Lose Part II's
   description block.

* en/book/ref-props.xml
   Delete this, moving its content...

* en/book/ch03-advanced-topics.xml
   ...to here.

* en/book/ref-davmodules.xml
   Delete this, too, moving its content...

* en/book/ch06-server-configuration.xml
   ...to here.

* en/book/ch05-repository-admin.xml
* en/book/ref-svn.xml
   Cleanup cross-references.

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

Deleted:
  /trunk/en/book/ref-davmodules.xml
  /trunk/en/book/ref-props.xml
Modified:
  /trunk/en/book/book.xml
  /trunk/en/book/ch03-advanced-topics.xml
  /trunk/en/book/ch05-repository-admin.xml
  /trunk/en/book/ch06-server-configuration.xml
  /trunk/en/book/ref-svn.xml

=======================================
--- /trunk/en/book/ref-davmodules.xml	Tue Feb  5 13:51:43 2013
+++ /dev/null
@@ -1,490 +0,0 @@
-<reference id="svn.ref.davmodules">
-  <title>Subversion Apache HTTP Server Module Reference</title>
-
-  <!-- ### TODO: partintro -->
-
-  <!-- =================================================================  
-->
-  <!-- =================================================================  
-->
-  <!-- =================================================================  
-->
-
-    <refentry id="svn.ref.mod_dav_svn.conf">
-      <refnamediv>
-        <refname>mod_dav_svn</refname>
-        <refpurpose>Subversion service module for Apache HTTP
-          Server</refpurpose>
-      </refnamediv>
-
-      <refsect1 id="svn.ref.mod_dav_svn.conf.desc">
-        <title>Description</title>
-
-        <para>This section briefly describes each Subversion
-          Apache configuration directive.  For an in-depth
-          description of configuring Apache with Subversion, see <xref
-          linkend="svn.serverconfig.httpd"/>.</para>
-
-      </refsect1>
-
-      <refsect1 id="svn.ref.mod_dav_svn.conf.directives">
-        <title>Directives</title>
-
-        <para>These are the <filename>httpd.conf</filename> directives
-          that apply to <command>mod_dav_svn</command>:</para>
-
-        <variablelist>
-
-          <varlistentry>
-            <term><literal>DAV svn</literal></term>
-            <listitem>
-
-              <para>Must be included in any
-                <literal>Directory</literal> or
-                <literal>Location</literal> block for a Subversion
-                repository.  It tells <command>httpd</command> to use the  
Subversion
-                backend for <literal>mod_dav</literal> to handle all
-                requests.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNActivitiesDB
-              <replaceable>directory-path</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the location in the filesystem where the
-                activities database should be stored.  By default,
-                <command>mod_dav_svn</command> creates and uses a  
directory in the
-                repository
-                called <filename>dav/activities.d</filename>.  The
-                path specified with this option must be an absolute
-                path.</para>
-
-              <para>If specified for
-                an <literal>SVNParentPath</literal> area,  
<command>mod_dav_svn</command>
-                appends the basename of the repository to the path
-                specified here.  For example:</para>
-
-              <informalexample>
-          <screen>
-<Location /svn>
-  DAV svn
-
-  # any "/svn/foo" URL will map to a repository in
-  # /net/svn.nfs/repositories/foo
-  SVNParentPath         "/net/svn.nfs/repositories"
-
-  # any "/svn/foo" URL will map to an activities db in
-  #  /var/db/svn/activities/foo
-  SVNActivitiesDB       "/var/db/svn/activities"
-</Location>
-</screen>
-        </informalexample>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNAdvertiseV2Protocol On|Off</literal></term>
-            <listitem>
-
-              <para>New to Subversion 1.7, this toggles
-                whether <command>mod_dav_svn</command> advertises its
-                support for the new version of its HTTP protocol also
-                introduced in that version.  Most admins will not wish
-                to use this directive (which is <literal>On</literal>
-                by default), choosing instead to enjoy the performance
-                benefits that the new protocol offers.  However, whena
-                configuring a server as a write-through proxy to
-                another server which does not support the new
-                protocol, set this directive's value
-                to <literal>Off</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNAllowBulkUpdates On|Off</literal></term>
-            <listitem>
-
-              <para>Toggles support for all-inclusive
-                responses to update-style <literal>REPORT</literal>
-                requests.  Subversion clients use
-                <literal>REPORT</literal> requests to get information
-                about directory tree checkouts and updates from
-                <command>mod_dav_svn</command>.  They can ask the
-                server to send that information in one of two ways:
-                with the entirety of the tree's information in one
-                massive response, or with a
-                <firstterm>skelta</firstterm> (a skeletal
-                representation of a tree delta) which contains just
-                enough information for the client to know what
-                <emphasis>additional</emphasis> data to request from
-                the server.  When this directive is included with a
-                value of <literal>Off</literal>,
-                <command>mod_dav_svn</command> will only ever respond
-                to these <literal>REPORT</literal> requests with
-                skelta responses, regardless of the type of responses
-                requested by the client.</para>
-
-              <para>Most folks won't need to use this directive at
-                all.  It primarily exists for administrators who
-                wish—for security or auditing reasons—to
-                force Subversion clients to fetch individually all the
-                files and directories needed for updates and
-                checkouts, thus leaving an audit trail of
-                <literal>GET</literal> and <literal>PROPFIND</literal>
-                requests in Apache's logs.  The default value of this
-                directive is <literal>On</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-          <varlistentry>
-            <term><literal>SVNAutoversioning On|Off</literal></term>
-            <listitem>
-
-              <para>When its value is
-                <literal>On</literal>, allows write requests from
-                WebDAV clients to result in automatic commits.  A
-                generic log message is auto-generated and attached to
-                each revision.  If you enable autoversioning, you'll
-                likely want to set <literal>ModMimeUsePathInfo
-                On</literal> so that <literal>mod_mime</literal> can
-                set <literal>svn:mime-type</literal> to the correct
-                MIME type automatically (as best as
-                <literal>mod_mime</literal> is able to, of course).
-                For more information, see <xref
-                linkend="svn.webdav"/>.  The default value of this
-                directive is <literal>Off</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNCacheFullTexts On|Off</literal></term>
-            <listitem>
-
-              <para>When set to <literal>On</literal>, this tells
-                Subversion to cache content fulltexts if sufficient
-                in-memory cache is available, which could offer a
-                significant performance benefit to the server.  (See
-                also the <literal>SVNInMemoryCacheSize</literal>
-                directive.)  The default value of this directive
-                is <literal>Off</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-          <varlistentry>
-            <term><literal>SVNCacheTextDeltas On|Off</literal></term>
-            <listitem>
-
-              <para>When set to <literal>On</literal>, this tells
-                Subversion to cache content deltas if sufficient
-                in-memory cache is available, which could offer a
-                significant performance benefit to the server.  (See
-                also the <literal>SVNInMemoryCacheSize</literal>
-                directive.)  The default value of this directive
-                is <literal>Off</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNCompressionLevel
-              <replaceable>level</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the compression level used when sending
-                file content over the network.  A value
-                of <literal>0</literal> disables compression
-                altogether, and <literal>9</literal> is the maximum
-                value.  <literal>5</literal> is the default
-                value.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNIndexXSLT
-              <replaceable>directory-path</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the URI of an XSL transformation for
-                directory indexes.  This directive is optional.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNInMemoryCacheSize
-              <replaceable>size</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the maximum size (in kbytes) per process
-                of Subversion's in-memory object cache.  The default
-                value is <literal>16384</literal>; use a value
-                of <literal>0</literal> to deactivate this cache
-                altogether.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNListParentPath On|Off</literal></term>
-            <listitem>
-
-              <para>When set to <literal>On</literal>, allows
-                a <literal>GET</literal>
-                of <literal>SVNParentPath</literal>, which results in
-                a listing of all repositories under that path.  The
-                default setting is
-                <literal>Off</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNMasterURI
-              <replaceable>url</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies a URI to the master Subversion
-                repository (used for a write-through proxy).</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNParentPath
-              <replaceable>directory-path</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the location in the filesystem of a
-                parent directory whose child directories are
-                Subversion repositories.  In a configuration block for
-                a Subversion repository, either this directive or
-                <literal>SVNPath</literal> must be present, but not
-                both.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNPath
-              <replaceable>directory-path</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the location in the
-                filesystem for a Subversion repository's files.  In a
-                configuration block for a Subversion repository,
-                either this directive or
-                <literal>SVNParentPath</literal> must be present, but
-                not both.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNPathAuthz On|Off| 
short_circuit</literal></term>
-            <listitem>
-
-              <para>Controls path-based authorization by enabling
-                subrequests (<literal>On</literal>), disabling
-                subrequests (<literal>Off</literal>; see <xref
-                linkend="svn.serverconfig.httpd.authz.pathauthzoff"/>),
-                or querying <command>mod_authz_svn</command> directly
-                (<literal>short_circuit</literal>).  The default
-                value of this directive is <literal>On</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNReposName
-              <replaceable>name</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the name of a Subversion repository for
-                use in <literal>HTTP GET</literal> responses.  This
-                value will be prepended to the title of all directory
-                listings (which are served when you navigate to a
-                Subversion repository with a web browser).  This
-                directive is optional.</para>
-
-               <note>
-                 <para>Subversion will not use the repository name as
-                   configured via this directive when trying to match
-                   rules in access control files.  The repository names
-                   used in that file's syntax are always derived from
-                   the repository URL.  See
-                   <xref  
linkend="svn.serverconfig.pathbasedauthz.getting-started"
-                   /> for details.</para>
-               </note>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNSpecialURI
-              <replaceable>component</replaceable></literal></term>
-            <listitem>
-
-              <para>Specifies the URI component (namespace) for
-                special Subversion resources.  The default is
-                <literal>!svn</literal>, and most
-                administrators will never use this directive.  Set
-                this only if there is a pressing need to have a file
-                named <filename>!svn</filename> in your repository.
-                If you change this on a server already in use, it will
-                break all of the outstanding working copies, and your
-                users will hunt you down with pitchforks and flaming
-                torches.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>SVNUseUTF8 On|Off</literal></term>
-            <listitem>
-
-              <para>When set to <literal>On</literal>,
-                <command>mod_dav_svn</command> will communicate with
-                hook scripts using repository root paths encoded in
-                UTF-8, and will expect those scripts to likewise
-                generate output (such as error messages) encoded in
-                UTF-8.  The default value of this option
-                is <literal>Off</literal>, which means
-                that <command>mod_dav_svn</command> assumes a 7-bit
-                ASCII encoding for its hook script interactions.  This
-                option is available as of Subversion 1.8.</para>
-
-              <note>
-                <para>Administrators should ensure that the character
-                  set and encoding expectations of hook scripts match
-                  all the ways they might be invoked.  For example, if
-                  one repository is served by both <command>httpd</command>
-                  and <command>svnserve</command>,  
<command>svnserve</command>
-                  should also be configured to use UTF-8 (by setting
-                  an appropriate locale in its environment) if this
-                  option is enabled for <command>mod_dav_svn</command>.
-                  Also, local filesystem paths containing non-ASCII
-                  characters which will be accessed by those scripts
-                  (such as repository root paths) must be properly
-                  encoded in the filesystem to match the scripts'
-                  expectations.</para>
-              </note>
-
-            </listitem>
-          </varlistentry>
-
-        </variablelist>
-      </refsect1>
-    </refentry>
-
-  <!-- =================================================================  
-->
-  <!-- =================================================================  
-->
-  <!-- =================================================================  
-->
-    <refentry id="svn.ref.mod_authz_svn.conf">
-      <refnamediv>
-        <refname>mod_authz_svn</refname>
-        <refpurpose>Subversion path-based authorization module for
-          Apache HTTP Server</refpurpose>
-      </refnamediv>
-
-      <refsect1 id="svn.ref.mod_authz_svn.conf.desc">
-        <title>Description</title>
-
-        <para>This section briefly describes each Apache configuration
-          directive offered by <command>mod_authz_svn</command>.  For
-          an in-depth description of using path-based authorization in
-          Subversion, see <xref  
linkend="svn.serverconfig.pathbasedauthz"/>.</para>
-
-      </refsect1>
-
-      <refsect1 id="svn.ref.mod_authz_svn.conf.directives">
-        <title>Directives</title>
-
-        <para>These are the <filename>httpd.conf</filename> directives
-          that apply to <command>mod_authz_svn</command>:</para>
-
-        <variablelist>
-
-          <varlistentry>
-            <term><literal>AuthzForceUsernameCase Upper| 
Lower</literal></term>
-            <listitem>
-
-              <para>Set to <literal>Upper</literal>
-                or <literal>Lower</literal> to perform case conversion
-                of the specified sort on the authenticated username
-                before checking it for authorization.  While usernames
-                are compared in a case-sensitive fashion against those
-                referenced in the authorization rules file, this
-                directive can at least normalize variably-cased
-                usernames into something consistent.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>AuthzSVNAccessFile
-              <replaceable>file-path</replaceable></literal></term>
-            <listitem>
-
-              <para>Consult <replaceable>file-path</replaceable> for
-                access rules describing the permissions for paths in
-                Subversion repository.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>AuthzSVNAnonymous On|Off</literal></term>
-            <listitem>
-
-              <para>Set to <literal>Off</literal> to disable two
-                special-case behaviours of this module: interaction
-                with the <literal>Satisfy Any</literal> directive and
-                enforcement of the authorization policy even when no
-                <literal>Require</literal> directives are present.
-                The default value of this directive is
-                <literal>On</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>AuthzSVNAuthoritative On|Off</literal></term>
-            <listitem>
-
-              <para>Set to <literal>Off</literal> to allow access
-                control to be passed along to lower modules.  The
-                default value of this directive is
-                <literal>On</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><literal>AuthzSVNNoAuthWhenAnonymousAllowed On| 
Off</literal></term>
-            <listitem>
-
-              <para>Set to <literal>On</literal> to suppress
-                authentication and authorization for requests which
-                anonymous users are allowed to perform.  The default
-                value of this directive is
-                <literal>On</literal>.</para>
-
-            </listitem>
-          </varlistentry>
-
-        </variablelist>
-      </refsect1>
-
-    </refentry>
-
-</reference>
-
-<!--
-local variables:
-sgml-parent-document: ("book.xml" "reference")
-end:
--->
=======================================
--- /trunk/en/book/ref-props.xml	Tue Feb  5 13:51:43 2013
+++ /dev/null
@@ -1,345 +0,0 @@
-<reference id="svn.ref.properties">
-  <title>Subversion Property Reference</title>
-
-  <partintro>
-
-    <para>Subversion uses properties—bits of metadata that are
-      stored along the user's versioned data but are not strictly part
-      of it—to provide a number of built-in behaviors and
-      features, and to offer users a place to stash out-of-band
-      information regarding their versioned data and the changes made
-      to it.  Subversion allows users to invent arbitrarily named
-      versioned properties on files and directories, as well as
-      unversioned properties on revisions.  The only restriction is on
-      properties whose names begin with <literal>svn:</literal> (those
-      are reserved for Subversion's own use).  While these properties
-      may be set by users to control Subversion's behavior, users may
-      not invent new <literal>svn:</literal> properties.</para>
-
-    <para>This reference describes the built-in properties which
-      toggle or otherwise support Subversion features.</para>
-
-  </partintro>
-
-  <!-- =================================================================  
-->
-  <!-- =================================================================  
-->
-  <!-- =================================================================  
-->
-
-    <!-- ===============================================================  
-->
-    <refentry id="svn.ref.properties.versioned-props">
-      <refnamediv>
-        <refname>Versioned Properties</refname>
-        <refpurpose>Properties associated with versioned files and
-          directories</refpurpose>
-      </refnamediv>
-
-      <refsect1 id="svn.ref.properties.versioned-props.list">
-        <title>Properties</title>
-
-
-      <para>These are the versioned properties that Subversion reserves
-        for its own use:</para>
-
-      <variablelist>
-
-        <varlistentry>
-          <term><literal>svn:auto-props</literal></term>
-          <listitem>
-
-            <para>If present on a directory, the value is a set of
-            automatic property definitions which apply to all files
-            under the directory,  See
-              <xref
-              linkend="svn.advanced.props.auto"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:executable</literal></term>
-          <listitem>
-
-            <para>If present on a file, the client will make the
-              file executable in Unix-hosted working copies.  See
-              <xref
-              linkend="svn.advanced.props.special.executable"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:mime-type</literal></term>
-          <listitem>
-
-            <para>If present on a file, the value indicates the
-              file's MIME type.  This allows the client to decide
-              whether line-based contextual merging is safe to
-              perform during updates, and can also affect how the
-              file behaves when fetched via a web browser.  See
-              <xref
-              linkend="svn.advanced.props.special.mime-type"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:ignore</literal></term>
-          <listitem>
-
-            <para>If present on a directory, the value is a list of
-              <emphasis>unversioned</emphasis> file patterns to be ignored
-              by <command>svn status</command> and other
-              subcommands.  See
-              <xref
-              linkend="svn.advanced.props.special.ignore"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:global-ignores</literal></term>
-          <listitem>
-
-            <para>If present on a directory, the value is a list of
-              <emphasis>unversioned</emphasis> file patterns to be ignored
-              by <command>svn status</command> and other
-              subcommands.  Unlike <literal>svn:ignore</literal>
-              these patterns apply to <emphasis>all</emphasis>
-              unversioned subtrees under the directory, not just the
-              directory's immediate file children.  See
-              <xref
-              linkend="svn.advanced.props.special.ignore"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:keywords</literal></term>
-          <listitem>
-
-            <para>If present on a file, the value tells the client
-              how to expand particular keywords within the file.
-              See
-              <xref
-              linkend="svn.advanced.props.special.keywords"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:eol-style</literal></term>
-          <listitem>
-
-            <para>If present on a file, the value tells the client how
-              to manipulate the file's line-endings in the working
-              copy and in exported trees.  See <xref
-              linkend="svn.advanced.props.special.eol-style"/> and
-              <xref linkend="svn.ref.svn.c.export" /> earlier in this  
chapter.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:externals</literal></term>
-          <listitem>
-
-            <para>If present on a directory, the value is a multiline
-              list of other paths and URLs the client should check
-              out.  See
-              <xref linkend="svn.advanced.externals"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:special</literal></term>
-          <listitem>
-
-            <para>If present on a file, indicates that the file is not
-              an ordinary file, but a symbolic link or other special
-              object.<footnote><para>As of this writing, symbolic
-              links are indeed the only <quote>special</quote>
-              objects.  But there might be more in future releases of
-              Subversion.</para></footnote></para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:needs-lock</literal></term>
-          <listitem>
-
-            <para>If present on a file, tells the client to make the
-              file read-only in the working copy, as a reminder that
-              the file should be locked before editing begins.  See
-              <xref
-              linkend="svn.advanced.locking.lock-communication"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:mergeinfo</literal></term>
-          <listitem>
-
-            <para>Used by Subversion to track merge data.  See
-              <xref linkend="svn.branchmerge.basicmerging.mergeinfo"/>
-              for details, but you should never edit this property
-              unless you <emphasis>really</emphasis> know what you're
-              doing.</para>
-
-          </listitem>
-        </varlistentry>
-
-      </variablelist>
-    </refsect1>
-  </refentry>
-
-    <!-- ===============================================================  
-->
-    <refentry id="svn.ref.properties.unversioned-props">
-      <refnamediv>
-        <refname>Unversioned (Revision) Properties</refname>
-        <refpurpose>Properties associated with global Subversion
-          revisions</refpurpose>
-      </refnamediv>
-
-    <refsect1 id="svn.ref.properties.unversioned-props.list">
-      <title>Properties</title>
-
-      <para>These are the unversioned properties that Subversion reserves
-        for its own use:</para>
-
-      <variablelist>
-
-        <varlistentry>
-          <term><literal>svn:author</literal></term>
-          <listitem>
-
-            <para>If present, contains the authenticated username of
-              the person who created the revision.  (If not present,
-              the revision was committed anonymously.)</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:autoversioned</literal></term>
-          <listitem>
-
-            <para>If present, the revision was created via the
-              autoversioning feature.  See
-              <xref linkend="svn.webdav.autoversioning"/>.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:date</literal></term>
-          <listitem>
-
-            <para>Contains the UTC time the revision was created, in
-              ISO 8601 format.  The value comes from the
-              <emphasis>server</emphasis> machine's clock, not the
-              client's.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:log</literal></term>
-          <listitem>
-
-            <para>Contains the log message describing the
-              revision.</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:rdump-lock</literal></term>
-          <listitem>
-
-            <para>Used to temporarily enforce mutually exclusive
-              access to the repository by <command>svnrdump
-              load</command>.  This property is generally only
-              observed when such an operation is active—or when
-              an <command>svnrdump</command> command failed to cleanly
-              disconnect from the repository.  (This property is only
-              relevant when it appears on revision 0.)</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:sync-currently-copying</literal></term>
-          <listitem>
-
-            <para>Contains the revision number from the source
-              repository which is currently being mirrored to this one
-              by the <command>svnsync</command> tool.  (This property
-              is only relevant when it appears on revision 0.)</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:sync-from-uuid</literal></term>
-          <listitem>
-
-            <para>Contains the UUID of the repository of which this
-              repository has been initialized as a mirror by
-              the <command>svnsync</command> tool.  (This property is
-              only relevant when it appears on revision 0.)</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:sync-from-url</literal></term>
-          <listitem>
-
-            <para>Contains the URL of the repository directory of
-              which this repository has been initialized as a mirror
-              by the <command>svnsync</command> tool.  (This property
-              is only relevant when it appears on revision 0.)</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:sync-last-merged-rev</literal></term>
-          <listitem>
-
-            <para>Contains the revision of the source repository which
-              was most recently and successfully mirrored to this one.
-              (This property is only relevant when it appears on
-              revision 0.)</para>
-
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><literal>svn:sync-lock</literal></term>
-          <listitem>
-
-            <para>Used to temporarily enforce mutually exclusive
-              access to the repository by <command>svnsync</command>
-              mirroring operations.  This property is generally only
-              observed when such an operation is active—or when
-              an <command>svnsync</command> command failed to cleanly
-              disconnect from the repository.  (This property is
-              only relevant when it appears on revision 0.)</para>
-
-          </listitem>
-        </varlistentry>
-
-      </variablelist>
-    </refsect1>
-  </refentry>
-</reference>
-
-<!--
-local variables:
-sgml-parent-document: ("book.xml" "reference")
-end:
--->
=======================================
--- /trunk/en/book/book.xml	Tue Feb  5 13:51:43 2013
+++ /trunk/en/book/book.xml	Wed Feb  6 09:33:02 2013
@@ -29,8 +29,6 @@
  <!ENTITY refsvndumpfilter    SYSTEM "ref-svndumpfilter.xml">
  <!ENTITY refsvnversion       SYSTEM "ref-svnversion.xml">
  <!ENTITY refsvnmucc          SYSTEM "ref-svnmucc.xml">
-<!ENTITY refdavmodules       SYSTEM "ref-davmodules.xml">
-<!ENTITY refprops            SYSTEM "ref-props.xml">
  <!ENTITY refreposhooks       SYSTEM "ref-reposhooks.xml">

  <!-- Part III:  Appendixes -->
@@ -133,16 +131,7 @@
    </part>

    <part id="svn.ref">
-    <title>Subversion Complete Reference</title>
-
-    <partintro>
-      <para>This portion of the book is intended to be a complete
-        reference to using Subversion.  It includes command summaries
-        and examples for all the command-line tools provided as part
-        of the stock Subversion distribution, configuration
-        information for the Subversion server modules, and other
-        information that lends itself to a reference format.</para>
-    </partintro>
+    <title>Subversion Command Reference</title>

      &refsvn;
      &refsvnadmin;
@@ -153,8 +142,6 @@
      &refsvnrdump;
      &refsvndumpfilter;
      &refsvnmucc;
-    &refdavmodules;
-    &refprops;
      &refreposhooks;
    </part>

=======================================
--- /trunk/en/book/ch03-advanced-topics.xml	Wed Feb  6 08:08:33 2013
+++ /trunk/en/book/ch03-advanced-topics.xml	Wed Feb  6 09:33:02 2013
@@ -736,7 +736,7 @@
        these properties are mentioned elsewhere in this or other
        chapters as part of the more general topics to which they are
        related.  For an exhaustive list of Subversion's predefined
-      properties, see <xref linkend="svn.ref.properties" />.</para>
+      properties, see <xref linkend="svn.advanced.props.ref" />.</para>

      <note>
        <para>While Subversion automatically attaches properties
@@ -1860,6 +1860,286 @@
          (See <xref linkend="svn.reposadmin.create.hooks"/> for more
          about hook scripts.)</para>

+    </sect2>
+
+    <!-- ===============================================================  
-->
+    <sect2 id="svn.advanced.props.ref">
+      <title>Subversion's Reserved Properties</title>
+
+      <para>In this section, we'll briefly summarize all the
+        properties which Subversion reserves for its own use.  We'll
+        look at both types of properties—those which are
+        associated with individual versioned files and directories,
+        and those which are associated with revisions.</para>
+
+      <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
-->
+      <sect3 id="svn.advanged.prop.reference.versioned">
+        <title>Versioned properties</title>
+
+        <para>These are the versioned (or node) properties that
+          Subversion reserves for its own use:</para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term><literal>svn:auto-props</literal></term>
+            <listitem>
+              <para>If present on a directory, the value is a set of
+                automatic property definitions which apply to all files
+                under the directory, See
+                <xref linkend="svn.advanced.props.auto" />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:executable</literal></term>
+            <listitem>
+              <para>If present on a file, the client will make the file
+                executable in Unix-hosted working copies.  See
+                <xref linkend="svn.advanced.props.special.executable"
+                />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:mime-type</literal></term>
+            <listitem>
+              <para>If present on a file, the value indicates the file's
+                MIME type.  This allows the client to decide whether
+                line-based contextual merging is safe to perform during
+                updates, and can also affect how the file behaves when
+                fetched via a web browser.  See
+                <xref linkend="svn.advanced.props.special.mime-type"
+                />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:ignore</literal></term>
+            <listitem>
+              <para>If present on a directory, the value is a list of
+                <emphasis>unversioned</emphasis> file patterns to be
+                ignored by <command>svn status</command> and other
+                subcommands.  See
+                <xref linkend="svn.advanced.props.special.ignore"
+                />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:global-ignores</literal></term>
+            <listitem>
+              <para>If present on a directory, the value is a list of
+                <emphasis>unversioned</emphasis> file patterns to be
+                ignored by <command>svn status</command> and other
+                subcommands.  Unlike <literal>svn:ignore</literal> these
+                patterns apply to <emphasis>all</emphasis> unversioned
+                subtrees under the directory, not just the directory's
+                immediate file children.  See
+                <xref linkend="svn.advanced.props.special.ignore"
+                />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:keywords</literal></term>
+            <listitem>
+              <para>If present on a file, the value tells the client how
+                to expand particular keywords within the file.  See
+                <xref linkend="svn.advanced.props.special.keywords"
+                />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:eol-style</literal></term>
+            <listitem>
+              <para>If present on a file, the value tells the client how
+                to manipulate the file's line-endings in the working
+                copy and in exported trees.  See
+                <xref linkend="svn.advanced.props.special.eol-style" />
+                and <xref linkend="svn.ref.svn.c.export" />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:externals</literal></term>
+            <listitem>
+              <para>If present on a directory, the value is a multiline
+                list of other paths and URLs the client should check
+                out.  See <xref linkend="svn.advanced.externals"
+                />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:special</literal></term>
+            <listitem>
+              <para>If present on a file, indicates that the file is not
+                an ordinary file, but a symbolic link or other special
+                object.<footnote><para>As of this writing, symbolic
+                links are indeed the only <quote>special</quote>
+                objects.  But there might be more in future releases of
+                Subversion.</para></footnote></para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:needs-lock</literal></term>
+            <listitem>
+              <para>If present on a file, tells the client to make the
+                file read-only in the working copy, as a reminder that
+                the file should be locked before editing begins.  See
+                <xref linkend="svn.advanced.locking.lock-communication"
+                />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:mergeinfo</literal></term>
+            <listitem>
+              <para>Used by Subversion to track merge data.  See
+                <xref linkend="svn.branchmerge.basicmerging.mergeinfo"
+                /> for details, but you should never edit this property
+                unless you <emphasis>really</emphasis> know what you're
+                doing.</para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+      </sect3>
+
+      <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
-->
+      <sect3 id="svn.advanged.prop.reference.unversioned">
+        <title>Unversioned properties</title>
+
+        <para>The following are the unversioned (or revision) properties
+          that Subversion reserves for its own use.  Most of these
+          appear on every revision in the repository, carrying important
+          information about the origin and nature of the changes made in
+          that revision.</para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term><literal>svn:author</literal></term>
+            <listitem>
+              <para>If present, contains the authenticated username of
+                the person who created the revision.  (If not present,
+                the revision was committed anonymously.)</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:autoversioned</literal></term>
+            <listitem>
+              <para>If present, the revision was created via the
+                autoversioning feature.  See
+                <xref linkend="svn.webdav.autoversioning" />.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:date</literal></term>
+            <listitem>
+              <para>Contains the UTC time the revision was created, in
+                ISO 8601 format.  The value comes from the
+                <emphasis>server</emphasis> machine's clock, not the
+                client's.</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:log</literal></term>
+            <listitem>
+              <para>Contains the log message describing the
+                revision.</para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+
+        <para>Certain auxiliary tools in the Subversion
+          toolchain—namely, <command>svnrdump</command>
+          and <command>svnsync</command>—also use unversioned
+          properties for their own accounting purposes.  These
+          properties are found only on revision 0 of repositories on
+          which these tools are operating.  For more about
+          <command>svnrdump</command> and <command>svnsync</command> and
+          the functionality they offer, see
+          <xref linkend="svn.reposadmin" />.  The following are the
+          properties created and managed by these tools.</para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term><literal>svn:rdump-lock</literal></term>
+            <listitem>
+              <para>Used to temporarily enforce mutually exclusive
+                access to the repository by <command>svnrdump
+                load</command>.  This property is generally only
+                observed when such an operation is active—or when
+                an <command>svnrdump</command> command failed to cleanly
+                disconnect from the repository.  (This property is only
+                relevant when it appears on revision 0.)</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:sync-currently-copying</literal></term>
+            <listitem>
+              <para>Contains the revision number from the source
+                repository which is currently being mirrored to this one
+                by the <command>svnsync</command> tool.  (This property
+                is only relevant when it appears on revision 0.)</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:sync-from-uuid</literal></term>
+            <listitem>
+              <para>Contains the UUID of the repository of which this
+                repository has been initialized as a mirror by
+                the <command>svnsync</command> tool.  (This property is
+                only relevant when it appears on revision 0.)</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:sync-from-url</literal></term>
+            <listitem>
+              <para>Contains the URL of the repository directory of
+                which this repository has been initialized as a mirror
+                by the <command>svnsync</command> tool.  (This property
+                is only relevant when it appears on revision 0.)</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:sync-last-merged-rev</literal></term>
+            <listitem>
+              <para>Contains the revision of the source repository which
+                was most recently and successfully mirrored to this one.
+                (This property is only relevant when it appears on
+                revision 0.)</para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>svn:sync-lock</literal></term>
+            <listitem>
+              <para>Used to temporarily enforce mutually exclusive
+                access to the repository by <command>svnsync</command>
+                mirroring operations.  This property is generally only
+                observed when such an operation is active—or when
+                an <command>svnsync</command> command failed to cleanly
+                disconnect from the repository.  (This property is
+                only relevant when it appears on revision 0.)</para>
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+      </sect3>
      </sect2>
    </sect1>

@@ -4950,9 +5230,9 @@
          author of the revision.  That is, the authenticated user's
          name is stored as the value of the
          <literal>svn:author</literal> property on the new revision
-        (see <xref linkend="svn.ref.properties"/>).  If the client was
-        not authenticated (i.e., if the server never issued an
-        authentication challenge), the revision's
+        (see <xref linkend="svn.advanced.props.ref"/>).  If the
+        client was not authenticated (i.e., if the server never issued
+        an authentication challenge), the revision's
          <literal>svn:author</literal> property is empty.</para>

      </sect2>
=======================================
--- /trunk/en/book/ch05-repository-admin.xml	Wed Feb  6 08:08:33 2013
+++ /trunk/en/book/ch05-repository-admin.xml	Wed Feb  6 09:33:02 2013
@@ -135,9 +135,8 @@
          a <filename>dav</filename> subdirectory
          unless <filename>mod_dav_svn</filename> is in use and hasn't
          been configured to store its activities database elsewhere.
-        See <xref linkend="svn.ref.mod_dav_svn.conf.directives"/> in
-        <xref linkend="svn.ref.mod_dav_svn.conf"/> for more
-        information.</para>
+        See <xref linkend="svn.serverconfig.httpd.ref.mod_dav_svn" />
+        for more information.</para>

      </note>

@@ -1492,7 +1491,7 @@
          can <quote>fix</quote> her log message remotely using
          <command>svn propset</command> (see <xref
          linkend="svn.ref.svn.c.propset"/> in
-        <xref linkend="svn.ref.properties"/>).  However, because of the
+        <xref linkend="svn.ref.svn"/>).  However, because of the
          potential to lose information forever, Subversion repositories
          are not, by default, configured to allow changes to
          unversioned properties—except by an
=======================================
--- /trunk/en/book/ch06-server-configuration.xml	Wed Feb  6 08:08:33 2013
+++ /trunk/en/book/ch06-server-configuration.xml	Wed Feb  6 09:33:02 2013
@@ -3570,14 +3570,473 @@
            complicated topic, but also wondrous when implemented.  For
            details, read <xref linkend="svn.webdav"/>.</para>

-        <para>Note that there are a number of other small tweaks one can
-          make to <command>mod_dav_svn</command> that are too obscure
-          to mention in this chapter.  For a complete list of
+        <para>Note that there are a number of other small tweaks one
+          can make to <command>mod_dav_svn</command> that perhaps do
+          not merit extensive coverage.  For those interested,
+          however, we provide a complete list of
            all <filename>httpd.conf</filename> directives
-          that <command>mod_dav_svn</command> responds to, see
-          <xref linkend="svn.ref.mod_dav_svn.conf.directives"/> in
-          <xref linkend="svn.ref.mod_dav_svn.conf"/>.</para>
+          to which <command>mod_dav_svn</command> responds in
+          <xref linkend="svn.serverconfig.httpd.ref.mod_dav_svn"
+          />.</para>
+
        </sect3>
+    </sect2>
+
+    <!-- ===============================================================  
-->
+    <sect2 id="svn.serverconfig.httpd.ref">
+      <title>Subversion Apache HTTP Server Configuration Reference</title>
+
+      <para>In the previous sections, we've mentioned numerous
+        directives that administrators can use in their
+        <filename>httpd.conf</filename> files to enable and configure
+        their Subversion server offering, introducing each directive
+        as we also introduce the functionality it toggles.  In this
+        section, we'll quickly summarize <emphasis>all</emphasis> the
+        configuration directives supported by both of the Apache HTTP
+        Server modules which are provided as part of the standard
+        Subversion distribution.</para>
+
+      <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
-->
+      <sect3 id="svn.serverconfig.httpd.ref.mod_dav_svn">
+        <title>mod_dav_svn configuration directives</title>
+
+        <para>The following configuration directives are recognized
+          and supported by Subversion's Apache HTTP Server module,
+          <command>mod_dav_svn</command>.</para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term><literal>DAV svn</literal></term>
+            <listitem>
+
+              <para>Must be included in any
+                <literal>Directory</literal> or <literal>Location</literal>
+                block for a Subversion repository.  It
+                tells <command>httpd</command> to use the Subversion
+                backend for <literal>mod_dav</literal> to handle all
+                requests.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNActivitiesDB
+              <replaceable>directory-path</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the location in the filesystem where the
+                activities database should be stored.  By default,
+                <command>mod_dav_svn</command> creates and uses a
+                directory in the repository
+                called <filename>dav/activities.d</filename>.  The
+                path specified with this option must be an absolute
+                path.</para>
+
+              <para>If specified for
+                an <literal>SVNParentPath</literal>
+                area, <command>mod_dav_svn</command> appends the
+                basename of the repository to the path specified here.
+                For example:</para>
+
+              <informalexample>
+          <screen>
+<Location /svn>
+  DAV svn
+
+  # any "/svn/foo" URL will map to a repository in
+  # /net/svn.nfs/repositories/foo
+  SVNParentPath         "/net/svn.nfs/repositories"
+
+  # any "/svn/foo" URL will map to an activities db in
+  #  /var/db/svn/activities/foo
+  SVNActivitiesDB       "/var/db/svn/activities"
+</Location>
+</screen>
+        </informalexample>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNAdvertiseV2Protocol On|Off</literal></term>
+            <listitem>
+
+              <para>New to Subversion 1.7, this toggles
+                whether <command>mod_dav_svn</command> advertises its
+                support for the new version of its HTTP protocol also
+                introduced in that version.  Most admins will not wish
+                to use this directive (which is <literal>On</literal>
+                by default), choosing instead to enjoy the performance
+                benefits that the new protocol offers.  However, whena
+                configuring a server as a write-through proxy to
+                another server which does not support the new
+                protocol, set this directive's value
+                to <literal>Off</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNAllowBulkUpdates On|Off</literal></term>
+            <listitem>
+
+              <para>Toggles support for all-inclusive
+                responses to update-style <literal>REPORT</literal>
+                requests.  Subversion clients use
+                <literal>REPORT</literal> requests to get information
+                about directory tree checkouts and updates from
+                <command>mod_dav_svn</command>.  They can ask the
+                server to send that information in one of two ways:
+                with the entirety of the tree's information in one
+                massive response, or with a
+                <firstterm>skelta</firstterm> (a skeletal
+                representation of a tree delta) which contains just
+                enough information for the client to know what
+                <emphasis>additional</emphasis> data to request from
+                the server.  When this directive is included with a
+                value of <literal>Off</literal>,
+                <command>mod_dav_svn</command> will only ever respond
+                to these <literal>REPORT</literal> requests with
+                skelta responses, regardless of the type of responses
+                requested by the client.</para>
+
+              <para>Most folks won't need to use this directive at
+                all.  It primarily exists for administrators who
+                wish—for security or auditing reasons—to
+                force Subversion clients to fetch individually all the
+                files and directories needed for updates and
+                checkouts, thus leaving an audit trail of
+                <literal>GET</literal> and <literal>PROPFIND</literal>
+                requests in Apache's logs.  The default value of this
+                directive is <literal>On</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><literal>SVNAutoversioning On|Off</literal></term>
+            <listitem>
+
+              <para>When its value is
+                <literal>On</literal>, allows write requests from
+                WebDAV clients to result in automatic commits.  A
+                generic log message is auto-generated and attached to
+                each revision.  If you enable autoversioning, you'll
+                likely want to set <literal>ModMimeUsePathInfo
+                On</literal> so that <literal>mod_mime</literal> can
+                set <literal>svn:mime-type</literal> to the correct
+                MIME type automatically (as best as
+                <literal>mod_mime</literal> is able to, of course).
+                For more information, see <xref
+                linkend="svn.webdav"/>.  The default value of this
+                directive is <literal>Off</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNCacheFullTexts On|Off</literal></term>
+            <listitem>
+
+              <para>When set to <literal>On</literal>, this tells
+                Subversion to cache content fulltexts if sufficient
+                in-memory cache is available, which could offer a
+                significant performance benefit to the server.  (See
+                also the <literal>SVNInMemoryCacheSize</literal>
+                directive.)  The default value of this directive
+                is <literal>Off</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><literal>SVNCacheTextDeltas On|Off</literal></term>
+            <listitem>
+
+              <para>When set to <literal>On</literal>, this tells
+                Subversion to cache content deltas if sufficient
+                in-memory cache is available, which could offer a
+                significant performance benefit to the server.  (See
+                also the <literal>SVNInMemoryCacheSize</literal>
+                directive.)  The default value of this directive
+                is <literal>Off</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNCompressionLevel
+              <replaceable>level</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the compression level used when sending
+                file content over the network.  A value
+                of <literal>0</literal> disables compression
+                altogether, and <literal>9</literal> is the maximum
+                value.  <literal>5</literal> is the default
+                value.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNIndexXSLT
+              <replaceable>directory-path</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the URI of an XSL transformation for
+                directory indexes.  This directive is optional.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNInMemoryCacheSize
+              <replaceable>size</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the maximum size (in kbytes) per process
+                of Subversion's in-memory object cache.  The default
+                value is <literal>16384</literal>; use a value
+                of <literal>0</literal> to deactivate this cache
+                altogether.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNListParentPath On|Off</literal></term>
+            <listitem>
+
+              <para>When set to <literal>On</literal>, allows
+                a <literal>GET</literal>
+                of <literal>SVNParentPath</literal>, which results in
+                a listing of all repositories under that path.  The
+                default setting is
+                <literal>Off</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNMasterURI
+              <replaceable>url</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies a URI to the master Subversion
+                repository (used for a write-through proxy).</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNParentPath
+              <replaceable>directory-path</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the location in the filesystem of a
+                parent directory whose child directories are
+                Subversion repositories.  In a configuration block for
+                a Subversion repository, either this directive or
+                <literal>SVNPath</literal> must be present, but not
+                both.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNPath
+              <replaceable>directory-path</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the location in the
+                filesystem for a Subversion repository's files.  In a
+                configuration block for a Subversion repository,
+                either this directive or
+                <literal>SVNParentPath</literal> must be present, but
+                not both.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNPathAuthz On|Off| 
short_circuit</literal></term>
+            <listitem>
+
+              <para>Controls path-based authorization by enabling
+                subrequests (<literal>On</literal>), disabling
+                subrequests (<literal>Off</literal>; see <xref
+                linkend="svn.serverconfig.httpd.authz.pathauthzoff"/>),
+                or querying <command>mod_authz_svn</command> directly
+                (<literal>short_circuit</literal>).  The default
+                value of this directive is <literal>On</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNReposName
+              <replaceable>name</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the name of a Subversion repository for
+                use in <literal>HTTP GET</literal> responses.  This
+                value will be prepended to the title of all directory
+                listings (which are served when you navigate to a
+                Subversion repository with a web browser).  This
+                directive is optional.</para>
+
+               <note>
+                 <para>Subversion will not use the repository name as
+                   configured via this directive when trying to match
+                   rules in access control files.  The repository names
+                   used in that file's syntax are always derived from
+                   the repository URL.  See
+                   <xref  
linkend="svn.serverconfig.pathbasedauthz.getting-started"
+                   /> for details.</para>
+               </note>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNSpecialURI
+              <replaceable>component</replaceable></literal></term>
+            <listitem>
+
+              <para>Specifies the URI component (namespace) for
+                special Subversion resources.  The default is
+                <literal>!svn</literal>, and most
+                administrators will never use this directive.  Set
+                this only if there is a pressing need to have a file
+                named <filename>!svn</filename> in your repository.
+                If you change this on a server already in use, it will
+                break all of the outstanding working copies, and your
+                users will hunt you down with pitchforks and flaming
+                torches.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNUseUTF8 On|Off</literal></term>
+            <listitem>
+
+              <para>When set to <literal>On</literal>,
+                <command>mod_dav_svn</command> will communicate with
+                hook scripts using repository root paths encoded in
+                UTF-8, and will expect those scripts to likewise
+                generate output (such as error messages) encoded in
+                UTF-8.  The default value of this option
+                is <literal>Off</literal>, which means
+                that <command>mod_dav_svn</command> assumes a 7-bit
+                ASCII encoding for its hook script interactions.  This
+                option is available as of Subversion 1.8.</para>
+
+              <note>
+                <para>Administrators should ensure that the character
+                  set and encoding expectations of hook scripts match
+                  all the ways they might be invoked.  For example, if
+                  one repository is served by both <command>httpd</command>
+                  and <command>svnserve</command>,  
<command>svnserve</command>
+                  should also be configured to use UTF-8 (by setting
+                  an appropriate locale in its environment) if this
+                  option is enabled for <command>mod_dav_svn</command>.
+                  Also, local filesystem paths containing non-ASCII
+                  characters which will be accessed by those scripts
+                  (such as repository root paths) must be properly
+                  encoded in the filesystem to match the scripts'
+                  expectations.</para>
+              </note>
+
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+      </sect3>
+
+      <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
-->
+      <sect3 id="svn.serverconfig.httpd.ref.mod_authz_svn">
+        <title>mod_authz_svn configuration directives</title>
+
+        <para>The following configuration directives are provided
+          by <command>mod_authz_svn</command>, Subversion's path-based
+          authorization Apache HTTP Server module.  For an in-depth
+          description of using path-based authorization in Subversion,
+          see <xref linkend="svn.serverconfig.pathbasedauthz"/>.</para>
+
+        <variablelist>
+
+          <varlistentry>
+            <term><literal>AuthzForceUsernameCase Upper| 
Lower</literal></term>
+            <listitem>
+
+              <para>Set to <literal>Upper</literal>
+                or <literal>Lower</literal> to perform case conversion
+                of the specified sort on the authenticated username
+                before checking it for authorization.  While usernames
+                are compared in a case-sensitive fashion against those
+                referenced in the authorization rules file, this
+                directive can at least normalize variably-cased
+                usernames into something consistent.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>AuthzSVNAccessFile
+              <replaceable>file-path</replaceable></literal></term>
+            <listitem>
+
+              <para>Consult <replaceable>file-path</replaceable> for
+                access rules describing the permissions for paths in
+                Subversion repository.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>AuthzSVNAnonymous On|Off</literal></term>
+            <listitem>
+
+              <para>Set to <literal>Off</literal> to disable two
+                special-case behaviours of this module: interaction
+                with the <literal>Satisfy Any</literal> directive and
+                enforcement of the authorization policy even when no
+                <literal>Require</literal> directives are present.
+                The default value of this directive is
+                <literal>On</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>AuthzSVNAuthoritative On|Off</literal></term>
+            <listitem>
+
+              <para>Set to <literal>Off</literal> to allow access
+                control to be passed along to lower modules.  The
+                default value of this directive is
+                <literal>On</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>AuthzSVNNoAuthWhenAnonymousAllowed On| 
Off</literal></term>
+            <listitem>
+
+              <para>Set to <literal>On</literal> to suppress
+                authentication and authorization for requests which
+                anonymous users are allowed to perform.  The default
+                value of this directive is
+                <literal>On</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+      </sect3>
+
      </sect2>
    </sect1>

=======================================
--- /trunk/en/book/ref-svn.xml	Tue Feb  5 13:51:43 2013
+++ /trunk/en/book/ref-svn.xml	Wed Feb  6 09:33:02 2013
@@ -4806,8 +4806,7 @@
            <tip>
              <para>Subversion has a number of <quote>special</quote>
                properties that affect its behavior.  See <xref
-              linkend="svn.ref.properties"/> later in this chapter for  
more on these
-              properties.</para>
+              linkend="svn.advanced.props.ref"/> for details.</para>
            </tip>

          </refsect1>




More information about the svnbook-dev mailing list