[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