[svnbook] r3905 committed - Finish issue #24 ("New 1.6 feature: Document --config-option option")....

svnbook at googlecode.com svnbook at googlecode.com
Mon Jul 11 11:05:54 CDT 2011


Revision: 3905
Author:   cmpilato at gmail.com
Date:     Mon Jul 11 09:05:11 2011
Log:      Finish issue #24 ("New 1.6 feature: Document --config-option  
option").

* src/en/book/ch07-customizing-svn.xml
   (svn.advanced.confarea.layout): Note the --config-option option.

* src/en/book/ch09-reference.xml
   (svn.ref.svn.sw): Document the --config-option option.

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

Modified:
  /trunk/src/en/book/ch07-customizing-svn.xml
  /trunk/src/en/book/ch09-reference.xml

=======================================
--- /trunk/src/en/book/ch07-customizing-svn.xml	Tue Jul  5 09:25:22 2011
+++ /trunk/src/en/book/ch07-customizing-svn.xml	Mon Jul 11 09:05:11 2011
@@ -98,6 +98,13 @@
          configuration directory with the default contents will be
          created.</para>

+      <para>Subversion also allows you to override individual
+        configuration option values at the command line via
+        the <option>--config-option</option> option, which is
+        especially useful if you need to make a (very) temporary
+        change in behavior.  For more about this option's proper
+        usage, see <xref linkend="svn.ref.svn.sw"/>.</para>
+
        <para>The per-user configuration area also contains a cache of
          authentication data.  The <filename>auth</filename> directory
          holds a set of subdirectories that contain pieces of cached
=======================================
--- /trunk/src/en/book/ch09-reference.xml	Fri Jul  8 13:43:10 2011
+++ /trunk/src/en/book/ch09-reference.xml	Mon Jul 11 09:05:11 2011
@@ -73,6 +73,29 @@
            </listitem>
          </varlistentry>

+        <varlistentry>
+          <term><option>--config-option</option>
+             
<replaceable>FILE</replaceable>:<replaceable>SECTION</replaceable>:<replaceable>OPTION</replaceable>=[<replaceable>VALUE</replaceable>]</term>
+          <listitem>
+            <para>Sets, for the duration of the command, the value of
+              a runtime configuration
+              option.  <replaceable>FILE</replaceable>
+              and <replaceable>SECTION</replaceable> are the runtime
+              configuration file (either <literal>config</literal>
+              or <literal>servers</literal>) and the section thereof,
+              respectively, which contain the option whose value you
+              wish to change.  <replaceable>OPTION</replaceable> is,
+              of course, the option itself,
+              and <replaceable>VALUE</replaceable> the value (if any)
+              you wish to assign to the option.  For example, to
+              temporarily disable the use of the automatic property
+              setting feature,
+              use  
<option>--config-option=config:miscellany:enable-auto-props=no</option>.
+              You can use this option multiple times to change
+              multiple option values simultaneously.</para>
+          </listitem>
+        </varlistentry>
+
          <varlistentry>
            <term><option>--no-auth-cache</option></term>
            <listitem>




More information about the svnbook-dev mailing list