[svnbook commit] r3264 - trunk/src/en/book

[Brian W. Fitzpatrick]

Thanks Mike!

-Fitz

On Mon, Aug 11, 2008 at 10:25 AM, cmpilato <noreply at red-bean.com> wrote:
> Author: cmpilato
> Date: Mon Aug 11 10:25:12 2008
> New Revision: 3264
>
> Log:
> Finish Trac ticket #125 (Document SVNPathAuthz short_circuit), and add
> a section for mod_authz_svn directives to the reference chapter.
>
> * en/book/ch09-reference.xml
>  (svn.ref.mod_dav_svn): Fix the SVNPathAuthz directive to not claim
>    to have a file-path value -- it's values are "On", "Off", or (the
>    newly-added) "short_circuit".
>  (svn.ref.mod_authz_svn): New section for mod_authz_svn directives.
>
>
> Modified:
>   trunk/src/en/book/ch09-reference.xml
>
> Modified: trunk/src/en/book/ch09-reference.xml
> ==============================================================================
> --- trunk/src/en/book/ch09-reference.xml        (original)
> +++ trunk/src/en/book/ch09-reference.xml        Mon Aug 11 10:25:12 2008
> @@ -8789,14 +8789,17 @@
>           </varlistentry>
>
>           <varlistentry>
> -            <term><literal>SVNPathAuthz
> -              <replaceable>file-path</replaceable></literal></term>
> +            <term><literal>SVNPathAuthz On|Off|short_circuit</literal></term>
>             <listitem>
>
> -              <para>Controls path-based authorization by enabling or
> -                disabling subrequests.  See
> -                <xref linkend="svn.serverconfig.httpd.authz.pathauthzoff"/>
> -                for details.</para>
> +              <para>Controls path-based authorization by enabling
> +                subrequests (<literal>On</literal>), disabling
> +                subrequests (<literal>Off</literal>), or querying
> +                <command>mod_authz_svn</command> directly
> +                (<literal>short_circuit</literal>).  See <xref
> +                linkend="svn.serverconfig.httpd.authz.pathauthzoff"/>
> +                for details.  By default, this directive's value is
> +                <literal>On</literal>.</para>
>
>             </listitem>
>           </varlistentry>
> @@ -9002,6 +9005,99 @@
>   <!-- ================================================================= -->
>   <!-- ================================================================= -->
>   <!-- ================================================================= -->
> +  <sect1 id="svn.ref.mod_authz_svn">
> +
> +    <title>mod_authz_svn</title>
> +
> +    <refentry id="svn.ref.mod_authz_svn.conf">
> +      <refnamediv>
> +
> +        <refname>mod_authz_svn Configuration Directives</refname>
> +        <refpurpose>Apache configuration directives for configuring
> +        path-based authorization for Subversion repositories served
> +        through the 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>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.  By
> +                default, this directive's value 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.  By default,
> +                this directive's value 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.  By default,
> +                this directive's value is
> +                <literal>Off</literal>.</para>
> +
> +            </listitem>
> +          </varlistentry>
> +
> +        </variablelist>
> +      </refsect1>
> +
> +    </refentry>
> +  </sect1>
> +
> +  <!-- ================================================================= -->
> +  <!-- ================================================================= -->
> +  <!-- ================================================================= -->
>   <sect1 id="svn.ref.properties">
>
>     <title>Subversion Properties</title>
>
> _______________________________________________
> svnbook-dev mailing list
> svnbook-dev at red-bean.com
> http://www.red-bean.com/mailman/listinfo/svnbook-dev
>