[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