[svnbook] r4430 committed - * en/book/ref-svnrdump.xml...

svnbook at googlecode.com svnbook at googlecode.com
Tue Feb 12 13:45:20 CST 2013


Revision: 4430
Author:   cmpilato at gmail.com
Date:     Tue Feb 12 11:45:09 2013
Log:      * en/book/ref-svnrdump.xml
   Indentation/whitespace/comment tweaks only.
http://code.google.com/p/svnbook/source/detail?r=4430

Modified:
  /trunk/en/book/ref-svnrdump.xml

=======================================
--- /trunk/en/book/ref-svnrdump.xml	Thu Feb  7 12:43:50 2013
+++ /trunk/en/book/ref-svnrdump.xml	Tue Feb 12 11:45:09 2013
@@ -14,164 +14,162 @@
        and <command>svnrdump</command>— in
        <xref linkend="svn.reposadmin.maint.migrate" />.</para>

-      <para>Options in <command>svnrdump</command> are global, just
-        as they are in <command>svn</command> and
-        <command>svnadmin</command>:</para>
+    <para>Options in <command>svnrdump</command> are global, just
+      as they are in <command>svn</command> and
+      <command>svnadmin</command>:</para>

-      <variablelist id="svn.ref.svnrdump.sw">
-        <title>svnrdump Options</title>
+    <variablelist id="svn.ref.svnrdump.sw">
+      <title>svnrdump Options</title>

-        <varlistentry id="svn.ref.svnrdump.sw.config_dir">
-          <term><option>--config-dir</option>  
<replaceable>DIR</replaceable></term>
-          <listitem>
-            <para>Instructs Subversion to read configuration
-              information from the specified directory instead of the
-              default location (<filename>.subversion</filename> in
-              the user's home directory).</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.config_dir">
+        <term><option>--config-dir</option>  
<replaceable>DIR</replaceable></term>
+        <listitem>
+          <para>Instructs Subversion to read configuration
+            information from the specified directory instead of the
+            default location (<filename>.subversion</filename> in
+            the user's home directory).</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.config_option">
-          <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 id="svn.ref.svnrdump.sw.config_option">
+        <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 id="svn.ref.svnrdump.sw.incremental">
-          <term><option>--incremental</option></term>
-          <listitem>
-            <para>Dump a revision or revision range only as a diff
-              against the previous revision, instead of the default,
-              which is begin a dumped revision range with a complete
-              expansion of all contents of the repository as of that
-              revision.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.incremental">
+        <term><option>--incremental</option></term>
+        <listitem>
+          <para>Dump a revision or revision range only as a diff
+            against the previous revision, instead of the default,
+            which is begin a dumped revision range with a complete
+            expansion of all contents of the repository as of that
+            revision.</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.no_auth_cache">
-          <term><option>--no-auth-cache</option></term>
-          <listitem>
-            <para>Prevents caching of authentication information
-              (e.g., username and password) in the Subversion
-              runtime configuration directories.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.no_auth_cache">
+        <term><option>--no-auth-cache</option></term>
+        <listitem>
+          <para>Prevents caching of authentication information
+            (e.g., username and password) in the Subversion
+            runtime configuration directories.</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.non_interactive">
-          <term><option>--non-interactive</option></term>
-          <listitem>
-            <para>In the case of an authentication failure or
-              insufficient credentials, prevents prompting for
-              credentials (e.g., username or password).  This is useful
-              if you're running Subversion inside an automated
-              script and it's more appropriate to have Subversion fail
-              than to prompt for more information.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.non_interactive">
+        <term><option>--non-interactive</option></term>
+        <listitem>
+          <para>In the case of an authentication failure or
+            insufficient credentials, prevents prompting for
+            credentials (e.g., username or password).  This is useful
+            if you're running Subversion inside an automated
+            script and it's more appropriate to have Subversion fail
+            than to prompt for more information.</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.password">
-          <term><option>--password</option>  
<replaceable>PASSWD</replaceable></term>
-          <listitem>
-            <para>Specifies the password to use when authenticating
-              against a Subversion server.  If not provided, or if
-              incorrect, Subversion will prompt you for this
-              information as needed.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.password">
+        <term><option>--password</option>  
<replaceable>PASSWD</replaceable></term>
+        <listitem>
+          <para>Specifies the password to use when authenticating
+            against a Subversion server.  If not provided, or if
+            incorrect, Subversion will prompt you for this
+            information as needed.</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.quiet">
-          <term><option>--quiet</option> (<option>-q</option>)</term>
-          <listitem>
-            <para>Requests that the client print only essential
-              information while performing an operation.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.quiet">
+        <term><option>--quiet</option> (<option>-q</option>)</term>
+        <listitem>
+          <para>Requests that the client print only essential
+            information while performing an operation.</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.revision">
-          <term><option>--revision</option> (<option>-r</option>)  
<replaceable>ARG</replaceable></term>
-          <listitem>
-            <para>Used by <command>svnsync copy-revprops</command> to
-              specify a particular revision or revision range on which
-              to operate.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.revision">
+        <term><option>--revision</option> (<option>-r</option>)  
<replaceable>ARG</replaceable></term>
+        <listitem>
+          <para>Used by <command>svnsync copy-revprops</command> to
+            specify a particular revision or revision range on which
+            to operate.</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.trust_server_cert">
-          <term><option>--trust-server-cert</option></term>
-          <listitem>
-            <para>Used with <option>--non-interactive</option> to accept
-              any unknown SSL server certificates without prompting.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.trust_server_cert">
+        <term><option>--trust-server-cert</option></term>
+        <listitem>
+          <para>Used with <option>--non-interactive</option> to accept
+            any unknown SSL server certificates without prompting.</para>
+        </listitem>
+      </varlistentry>

-        <varlistentry id="svn.ref.svnrdump.sw.username">
-          <term><option>--username</option>  
<replaceable>NAME</replaceable></term>
-          <listitem>
-            <para>Specifies the username to use when authenticating
-              against a Subversion server.  If not provided, or if
-              incorrect, Subversion will prompt you for this
-              information as needed.</para>
-          </listitem>
-        </varlistentry>
+      <varlistentry id="svn.ref.svnrdump.sw.username">
+        <term><option>--username</option>  
<replaceable>NAME</replaceable></term>
+        <listitem>
+          <para>Specifies the username to use when authenticating
+            against a Subversion server.  If not provided, or if
+            incorrect, Subversion will prompt you for this
+            information as needed.</para>
+        </listitem>
+      </varlistentry>

-      </variablelist>
+    </variablelist>

    </partintro>

-    <!-- ===============================================================  
-->
+  <!-- =============================================================== -->
+  <refentry id="svn.ref.svnrdump.c.dump">

-      <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
-->
-      <refentry id="svn.ref.svnrdump.c.dump">
+    <indexterm>
+      <primary>svnrdump</primary>
+      <secondary>subcommands</secondary>
+      <tertiary>dump</tertiary>
+    </indexterm>

-        <indexterm>
-          <primary>svnrdump</primary>
-          <secondary>subcommands</secondary>
-          <tertiary>dump</tertiary>
-        </indexterm>
-
-        <refnamediv>
-          <refname>svnrdump dump</refname>
-          <refpurpose></refpurpose>
-        </refnamediv>
-        <refsect1>
-          <title>Synopsis</title>
-          <para><literal>svnrdump dump SOURCE_URL</literal></para>
-        </refsect1>
-        <refsect1>
-          <title>Description</title>
+    <refnamediv>
+      <refname>svnrdump dump</refname>
+      <refpurpose></refpurpose>
+    </refnamediv>
+    <refsect1>
+      <title>Synopsis</title>
+      <para><literal>svnrdump dump SOURCE_URL</literal></para>
+    </refsect1>
+    <refsect1>
+      <title>Description</title>

-          <para>Dump—that is, generate a repository dump stream
-            of—revisions of the repository item located
-            at <replaceable>SOURCE_URL</replaceable>, printing the
-            information to standard output.  By default, the entire
-            history will be included in the dump stream, but the scope
-            of the operation can be limited via the use of
-            the <option>--revision</option> (<option>-r</option>)
-            option.</para>
+      <para>Dump—that is, generate a repository dump stream
+        of—revisions of the repository item located
+        at <replaceable>SOURCE_URL</replaceable>, printing the
+        information to standard output.  By default, the entire
+        history will be included in the dump stream, but the scope
+        of the operation can be limited via the use of
+        the <option>--revision</option> (<option>-r</option>)
+        option.</para>

-        </refsect1>
+    </refsect1>

-        <refsect1>
-          <title>Options</title>
+    <refsect1>
+      <title>Options</title>

-          <informalexample>
-            <screen>
+      <informalexample>
+        <screen>
  <xref linkend="svn.ref.svnrdump.sw.config_dir" />
  <xref linkend="svn.ref.svnrdump.sw.config_option" />
  <xref linkend="svn.ref.svnrdump.sw.incremental" />
@@ -183,108 +181,108 @@
  <xref linkend="svn.ref.svnrdump.sw.trust_server_cert" />
  <xref linkend="svn.ref.svnrdump.sw.username" />
  </screen>
-          </informalexample>
-        </refsect1>
+      </informalexample>
+    </refsect1>

-        <refsect1>
-          <title>Examples</title>
+    <refsect1>
+      <title>Examples</title>

-          <para>Generate a dump stream of the full history of a remote
-            repository (assuming that the user as who this runs has
-            authorization to read all paths in the repository).</para>
+      <para>Generate a dump stream of the full history of a remote
+        repository (assuming that the user as who this runs has
+        authorization to read all paths in the repository).</para>

-          <informalexample>
-            <screen>
+      <informalexample>
+        <screen>
  $ svnrdump dump http://svn.example.com/repos/calc > full.dump
  * Dumped revision 0.
  * Dumped revision 1.
  * Dumped revision 2.
  …
  </screen>
-          </informalexample>
+      </informalexample>

-          <para>Incrementally dump a single revision from that same
-            repository:</para>
+      <para>Incrementally dump a single revision from that same
+        repository:</para>

-          <informalexample>
-            <screen>
+      <informalexample>
+        <screen>
  $ svnrdump dump http://svn.example.com/repos/calc \
             -r 21 --incremental > full.dump
  * Dumped revision 21.
  $
  </screen>
-          </informalexample>
+      </informalexample>

-        </refsect1>
-      </refentry>
+    </refsect1>
+  </refentry>

-      <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
-->
-      <refentry id="svn.ref.svnrdump.c.help">
+  <!-- =============================================================== -->
+  <refentry id="svn.ref.svnrdump.c.help">

-        <indexterm>
-          <primary>svnrdump</primary>
-          <secondary>subcommands</secondary>
-          <tertiary>help</tertiary>
-        </indexterm>
+    <indexterm>
+      <primary>svnrdump</primary>
+      <secondary>subcommands</secondary>
+      <tertiary>help</tertiary>
+    </indexterm>

-        <refnamediv>
-          <refname>svnrdump help</refname>
-          <refpurpose>Help!</refpurpose>
-        </refnamediv>
-        <refsect1>
+    <refnamediv>
+      <refname>svnrdump help</refname>
+      <refpurpose>Help!</refpurpose>
+    </refnamediv>
+    <refsect1>

-          <title>Synopsis</title>
-          <para><literal>svnrdump help</literal></para>
-        </refsect1>
-        <refsect1>
-          <title>Description</title>
+      <title>Synopsis</title>
+      <para><literal>svnrdump help</literal></para>
+    </refsect1>
+    <refsect1>
+      <title>Description</title>

-          <para>Use this to get help.  Well, certain kinds of help.
-            Need white lab coat and straightjackets kind of help?
-            There's a whole different protocol for that sort of
-            thing.</para>
-
-        </refsect1>
+      <para>Use this to get help.  Well, certain kinds of help.
+        Need white lab coat and straightjackets kind of help?
+        There's a whole different protocol for that sort of
+        thing.</para>
+
+    </refsect1>

-        <refsect1>
-          <title>Options</title>
-          <para>None</para>
-        </refsect1>
+    <refsect1>
+      <title>Options</title>
+      <para>None</para>
+    </refsect1>

-      </refentry>
+  </refentry>

-      <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
-->
-      <refentry id="svn.ref.svnrdump.c.load">
+  <!-- =============================================================== -->
+  <refentry id="svn.ref.svnrdump.c.load">

-        <indexterm>
-          <primary>svnrdump</primary>
-          <secondary>subcommands</secondary>
-          <tertiary>load</tertiary>
-        </indexterm>
+    <indexterm>
+      <primary>svnrdump</primary>
+      <secondary>subcommands</secondary>
+      <tertiary>load</tertiary>
+    </indexterm>

-        <refnamediv>
-          <refname>svnrdump load</refname>
-          <refpurpose></refpurpose>
-        </refnamediv>
-        <refsect1>
-          <title>Synopsis</title>
-          <para><literal>svnrdump load DEST_URL</literal></para>
-        </refsect1>
-        <refsect1>
-          <title>Description</title>
+    <refnamediv>
+      <refname>svnrdump load</refname>
+      <refpurpose></refpurpose>
+    </refnamediv>
+    <refsect1>
+      <title>Synopsis</title>
+      <para><literal>svnrdump load DEST_URL</literal></para>
+    </refsect1>
+    <refsect1>
+      <title>Description</title>

-          <para>Read from standard input revision information
-            described in a Subversion repository dump stream, and load
-            that information into the repository located
-            at <replaceable>DEST_URL</replaceable>.</para>
+      <para>Read from standard input revision information
+        described in a Subversion repository dump stream, and load
+        that information into the repository located
+        at <replaceable>DEST_URL</replaceable>.</para>

-        </refsect1>
-
-        <refsect1>
-          <title>Options</title>
+    </refsect1>
+
+    <refsect1>
+      <title>Options</title>

-          <informalexample>
-            <screen>
+      <informalexample>
+        <screen>
  <xref linkend="svn.ref.svnrdump.sw.config_dir" />
  <xref linkend="svn.ref.svnrdump.sw.config_option" />
  <xref linkend="svn.ref.svnrdump.sw.no_auth_cache" />
@@ -294,19 +292,19 @@
  <xref linkend="svn.ref.svnrdump.sw.trust_server_cert" />
  <xref linkend="svn.ref.svnrdump.sw.username" />
  </screen>
-          </informalexample>
-        </refsect1>
+      </informalexample>
+    </refsect1>

-        <refsect1>
-          <title>Examples</title>
+    <refsect1>
+      <title>Examples</title>

-          <para>Dump the contents of a local repository, and
-            use <command>svnrdump load</command> to transfer that
-            revision information into an existing remote
-            repository:</para>
+      <para>Dump the contents of a local repository, and
+        use <command>svnrdump load</command> to transfer that
+        revision information into an existing remote
+        repository:</para>

-          <informalexample>
-            <screen>
+      <informalexample>
+        <screen>
  $ svnadmin dump -q /var/svn/repos/new-project | \
        svnrdump load http://svn.example.com/repos/new-project
  * Loaded revision 0
@@ -314,19 +312,19 @@
  * Loaded revision 2.
  …
  </screen>
-          </informalexample>
+      </informalexample>

-          <note>
-            <para>To operate properly <command>svnrdump load</command>
-              requires that the target repository have revision
-              property modification enabled via the pre-revprop-change
-              hook.  For details about that hook, see
-              <xref linkend="svn.ref.reposhooks.pre-revprop-change"
-              />.</para>
-          </note>
+      <note>
+        <para>To operate properly <command>svnrdump load</command>
+          requires that the target repository have revision
+          property modification enabled via the pre-revprop-change
+          hook.  For details about that hook, see
+          <xref linkend="svn.ref.reposhooks.pre-revprop-change"
+          />.</para>
+      </note>

-        </refsect1>
-      </refentry>
+    </refsect1>
+  </refentry>

  </reference>





More information about the svnbook-dev mailing list