[svnbook] r4019 committed - * en/book/ch09-reference.xml...

[svnbook at googlecode.com]

Revision: 4019
Author:   cmpilato at gmail.com
Date:     Fri Aug 19 08:33:48 2011
Log:      * en/book/ch09-reference.xml
   Document svnsync's --config-option, --disable-locking,
   --source-prop-encoding, and --steal-locks options.

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

Modified:
  /trunk/en/book/ch09-reference.xml

=======================================
--- /trunk/en/book/ch09-reference.xml	Fri Aug 19 07:58:35 2011
+++ /trunk/en/book/ch09-reference.xml	Fri Aug 19 08:33:48 2011
@@ -7984,6 +7984,40 @@
            </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=servers:global:http-library=serf</option>.
+              You can use this option multiple times to change
+              multiple option values simultaneously.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term><option>--disable-locking</option></term>
+          <listitem>
+            <para>Causes <command>svnsync</command> to bypass its own
+              exclusive access mechanisms and operate on the
+              assumption that its exclusive access to the mirror
+              repository is being guaranteed through some other,
+              out-of-band mechanism.</para>
+          </listitem>
+        </varlistentry>
+
          <varlistentry>
            <term><option>--no-auth-cache</option></term>
            <listitem>
@@ -8034,6 +8068,19 @@
            </listitem>
          </varlistentry>

+        <varlistentry>
+          <term><option>--source-prop-encoding
+            <replaceable>ARG</replaceable></option>
+          <listitem>
+            <para>Instructs <command>svnsync</command> to assume that
+              translatable Subversion revision properties found in the
+              source repository are stored using the character
+              encoding <replaceable>ARG</replaceable> and to transcode
+              those into UTF-8 when copying them into the mirror
+              repository.</para>
+          </listitem>
+        </varlistentry>
+
          <varlistentry>
            <term><option>--source-username</option>
              <replaceable>NAME</replaceable></term>
@@ -8044,6 +8091,20 @@
                information as needed.</para>
            </listitem>
          </varlistentry>
+
+        <varlistentry>
+          <term><option>--steal-lock</option></term>
+          <listitem>
+            <para>Causes <command>svnsync</command> to steal, as
+              necessary, the lock which it uses on the mirror
+              repository to ensure exclusive repository access.  (This
+              option should only be used when a lock exists in the
+              mirror repository and is known to be stale—that
+              is, when you are certain that there are no
+              other <command>svnsync</command> processes accessing
+              that repository.)</para>
+          </listitem>
+        </varlistentry>

          <varlistentry>
            <term><option>--sync-password</option>
@@ -8153,12 +8214,16 @@
            <informalexample>
              <screen>
  --config-dir DIR
+--config-option
+--disable-locking
  --no-auth-cache
  --non-interactive
  --quiet (-q)
  --revision (-r)
  --source-password ARG
+--source-prop-encoding
  --source-username ARG
+--steal-lock
  --sync-password ARG
  --sync-username ARG
  --trust-server-cert
@@ -8253,6 +8318,7 @@
            <informalexample>
              <screen>
  --config-dir DIR
+--config-option
  --no-auth-cache
  --non-interactive
  --source-password ARG
@@ -8352,12 +8418,17 @@

            <informalexample>
              <screen>
+--allow-non-empty
  --config-dir DIR
+--config-option
+--disable-locking
  --no-auth-cache
  --non-interactive
  --quiet (-q)
  --source-password ARG
+--source-prop-encoding
  --source-username ARG
+--steal-lock
  --sync-password ARG
  --sync-username ARG
  --trust-server-cert
@@ -8458,11 +8529,15 @@
            <informalexample>
              <screen>
  --config-dir DIR
+--config-option
+--disable-locking
  --no-auth-cache
  --non-interactive
  --quiet (-q)
  --source-password ARG
+--source-prop-encoding
  --source-username ARG
+--steal-lock
  --sync-password ARG
  --sync-username ARG
  --trust-server-cert