[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