[svnbook commit] r3529 - * trunk/src/de/book/ch09-reference.xml

codesite-noreply at google.com codesite-noreply at google.com
Thu May 28 06:02:11 CDT 2009


Author: jmfelderhoff at gmx.eu
Date: Thu May 28 04:01:45 2009
New Revision: 3529

Modified:
    trunk/src/de/book/ch09-reference.xml

Log:
* trunk/src/de/book/ch09-reference.xml
   - Fixes ticket #259 (cf. http://www.svnbook.de/report/6).


Modified: trunk/src/de/book/ch09-reference.xml
==============================================================================
--- trunk/src/de/book/ch09-reference.xml	(original)
+++ trunk/src/de/book/ch09-reference.xml	Thu May 28 04:01:45 2009
@@ -1,20 +1,31 @@
  <chapter id="svn.ref">
+<!--
    <title>Subversion Complete Reference</title>
-
+-->
+  <title>Die komplette Subversion Referenz</title>
+
+<!--
    <para>This chapter is intended to be a complete reference to using
      Subversion.  This includes the command-line client
      (<command>svn</command>) and all its subcommands, as well as the
      repository administration programs (<command>svnadmin</command>
      and <command>svnlook</command>) and their respective
      subcommands.</para>
+-->
+  <para>Dieses Kapitel soll als vollständige Referenz für die
+    Verwendung von Subversion dienen. Es umfasst sowohl den
+    Kommandozeilen-Client (<command>svn</command>) und all seine
+    Unterbefehle als auch die Repository-Verwaltungsprogramme
+    (<command>svnadmin</command> und <command>svnlook</command>) und
+    deren Unterbefehle.</para>
+

-
    <!-- =================================================================  
-->
    <!-- =================================================================  
-->
    <!-- =================================================================  
-->
    <sect1 id="svn.ref.svn">
      <title>The Subversion Command-Line Client:  
<command>svn</command></title>
-
+
      <para>To use the command-line client, type
        <command>svn</command>, the subcommand you wish to use,
        <footnote>
@@ -36,11 +47,11 @@
      <para>You can find many more examples of how to use most client
        commands in <xref linkend="svn.tour"/> and commands for managing
        properties in <xref linkend="svn.advanced.props"/>.</para>
-
+
      <!-- ===============================================================  
-->
      <sect2 id="svn.ref.svn.sw">
        <title>svn Options</title>
-
+
        <para>While Subversion has different options for its
          subcommands, all options exist in a single
          namespace—that is, each option is guaranteed to mean the
@@ -60,7 +71,7 @@
          was done to assist folks who write scripts which wrap the
          command-line client.  These global options are as
          follows:</para>
-
+
        <variablelist>

          <varlistentry>
@@ -117,14 +128,14 @@
                information as needed.</para>
            </listitem>
          </varlistentry>
-
+
        </variablelist>

        <para>The rest of the options apply and are accepted by only a
          subset of the subcommand.  They are as follows:</para>

        <variablelist>
-
+
          <varlistentry>
            <term><option>--accept</option>
              <replaceable>ACTION</replaceable></term>
@@ -145,7 +156,7 @@
                <filename>config</filename> file.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--change</option> (<option>-c</option>)
              <replaceable>ARG</replaceable></term>
@@ -202,7 +213,7 @@
                in this section).</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--diff3-cmd</option>
              <replaceable>CMD</replaceable></term>
@@ -210,7 +221,7 @@
              <para>Specifies an external program to use to merge  
files.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--dry-run</option></term>
            <listitem>
@@ -219,7 +230,7 @@
                the repository.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--editor-cmd</option>
              <replaceable>CMD</replaceable></term>
@@ -230,7 +241,7 @@
                for ways to specify a default editor.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--encoding</option>  
<replaceable>ENC</replaceable></term>
            <listitem>
@@ -261,7 +272,7 @@
            <!-- TODO(fitz): Document -u -b -w and - -ignore-eol-style -->

          </varlistentry>
-
+
          <varlistentry>
            <term><option>--file</option> (<option>-F</option>)
              <replaceable>FILENAME</replaceable>
@@ -290,7 +301,7 @@
                you're doing, you're likely to get a nasty shock.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--force-log</option></term>
            <listitem>
@@ -311,7 +322,7 @@
                option to subcommands that accept log messages.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--help</option> (<option>-h</option>) or
                  <option>-?</option>)
@@ -322,7 +333,7 @@
                the general client help text.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--ignore-ancestry</option></term>
            <listitem>
@@ -330,7 +341,7 @@
                differences (rely on path contents alone).</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--ignore-externals</option></term>
            <listitem>
@@ -338,7 +349,7 @@
                the external working copies managed by them.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--incremental</option></term>
            <listitem>
@@ -346,14 +357,14 @@
                concatenation.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--keep-changelists</option></term>
            <listitem>
              <para>Tells Subversion not to delete changelists after  
committing.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--keep-local</option></term>
            <listitem>
@@ -361,7 +372,7 @@
                with the <command>svn delete</command> command).</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--limit</option> (<option>-l</option>)
              <replaceable>NUM</replaceable></term>
@@ -370,7 +381,7 @@
                log messages.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--message</option> (<option>-m</option>)
              <replaceable>MESSAGE</replaceable>
@@ -379,13 +390,13 @@
              <para>Indicates that you will specify either a log message
                or a lock comment on the command line, following this
                option.  For example:</para>
-
+
              <screen>
  $ svn commit -m "They don't make Sunday."
  </screen>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--new</option>  
<replaceable>ARG</replaceable></term>
            <listitem>
@@ -393,7 +404,7 @@
                target (for use with <command>svn diff</command>).</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--no-auto-props</option></term>
            <listitem>
@@ -413,7 +424,7 @@
                the file but removed all the content.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--no-ignore</option></term>
            <listitem>
@@ -483,7 +494,7 @@
                information while performing an operation.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--record-only</option></term>
            <listitem>
@@ -491,7 +502,7 @@
                <option>--revision</option>).</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--recursive</option> (<option>-R</option>)</term>
            <listitem>
@@ -499,7 +510,7 @@
                Most subcommands recurse by default.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--reintegrate</option></term>
            <listitem>
@@ -510,7 +521,7 @@
                for details.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--relocate</option> <replaceable>FROM TO
            [PATH...]</replaceable></term>
@@ -524,7 +535,7 @@
                example.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--remove</option>
              <replaceable>ARG</replaceable></term>
@@ -533,7 +544,7 @@
                changelist</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--revision</option> (<option>-r</option>)
              <replaceable>REV</replaceable>
@@ -559,7 +570,7 @@
                information.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--revprop</option></term>
            <listitem>
@@ -570,7 +581,7 @@
                option.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--set-depth</option>
              <replaceable>ARG</replaceable></term>
@@ -590,7 +601,7 @@
                or <literal>eligible</literal> revisions.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--show-updates</option>  
(<option>-u</option>)</term>
            <listitem>
@@ -602,7 +613,7 @@
              </para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--stop-on-copy</option></term>
            <listitem>
@@ -614,7 +625,7 @@
                encountered.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--strict</option></term>
            <listitem>
@@ -623,7 +634,7 @@
                subcommands (namely, <command>svn propget</command>).</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--targets</option>
              <replaceable>FILENAME</replaceable></term>
@@ -634,7 +645,7 @@
              </para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--use-merge-history</option>
              (<option>-g</option>)</term>
@@ -643,7 +654,7 @@
                history.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--verbose</option> (<option>-v</option>)</term>
            <listitem>
@@ -654,7 +665,7 @@
                additional information regarding its actions.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--version</option></term>
            <listitem>
@@ -666,7 +677,7 @@
                prints only the version number in a compact form.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--with-all-revprops</option></term>
            <listitem>
@@ -696,11 +707,11 @@
              <para>Prints output in XML format.</para>
            </listitem>
          </varlistentry>
-
+
        </variablelist>
-
+
      </sect2>
-
+
      <!-- ===============================================================  
-->
      <sect2 id="svn.ref.svn.c">
        <title>svn Subcommands</title>
@@ -729,7 +740,7 @@
          </refsect1>
          <refsect1>
            <title>Description</title>
-
+
            <para>Schedule files, directories, or symbolic links in your
              working copy for addition to the repository.  They will be
              uploaded and added to the repository on your next commit.
@@ -738,12 +749,12 @@
              <command>svn revert</command>.
            </para>
          </refsect1>
-
+
          <refsect1>
            <title>Alternate names</title>
            <para>None</para>
          </refsect1>
-
+
          <refsect1>
            <title>Changes</title>
            <para>Working copy</para>
@@ -753,7 +764,7 @@
            <title>Accesses repository</title>
            <para>No</para>
          </refsect1>
-
+
          <refsect1>
            <title>Options</title>

@@ -768,10 +779,10 @@
  --targets FILENAME
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>
-
+
            <para>To add a file to your working copy:</para>

            <screen>
@@ -781,7 +792,7 @@

            <para>When adding a directory, the default behavior of
              <command>svn add</command> is to recurse:</para>
-
+
            <screen>
  $ svn add testdir
  A         testdir
@@ -793,7 +804,7 @@

            <para>You can add a directory without adding its
              contents:</para>
-
+
            <screen>
  $ svn add --depth=empty otherdir
  A         otherdir
@@ -838,7 +849,7 @@
          </refsect1>
          <refsect1>
            <title>Description</title>
-
+
            <para>Show author and revision information inline for the
              specified files or URLs.  Each line of text is annotated
              at the beginning with the author (username) and the
@@ -974,7 +985,7 @@
          </refsect1>
          <refsect1>
            <title>Description</title>
-
+
            <para>Output the contents of the specified files or URLs.
              For listing the contents of directories, see <command>svn
              list</command> later in this chapter.</para>
@@ -1031,7 +1042,7 @@
  $ svn cat -r HEAD foo.c
  Latest revision fresh from the repository!
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -1055,7 +1066,7 @@
          </refsect1>
          <refsect1>
            <title>Description</title>
-
+
            <para>Used for dividing files in a working copy into a
              changelist (logical named grouping) in order to allow
              users to easily work on multiple file collections within a
@@ -1127,7 +1138,7 @@
            <para>Note that only the files in changelist
              <replaceable>issue1729</replaceable> were
              committed.</para>
-
+
          </refsect1>
        </refentry>

@@ -1149,7 +1160,7 @@
          </refsect1>
          <refsect1>
            <title>Description</title>
-
+
            <para>Check out a working copy from a repository.  If
              <replaceable>PATH</replaceable> is omitted, the
              basename of the URL will be used as the destination.
@@ -1177,7 +1188,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --depth ARG
  --force
@@ -1186,7 +1197,7 @@
  --revision (-r) REV
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>

@@ -1401,7 +1412,7 @@
          </refsect1>


-
+
          <refsect1>
            <title>Alternate names</title>
            <para><command>ci</command> (short for <quote>check in</quote>;  
not
@@ -1445,7 +1456,7 @@
              commit message on the command line and an implicit
              target of your current directory
              (<quote><filename>.</filename></quote>):</para>
-
+
            <screen>
  $ svn commit -m "added howto section."
  Sending        a
@@ -1489,7 +1500,7 @@

  Committed revision 7.
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -1514,14 +1525,14 @@

          <refsect1>
            <title>Description</title>
-
+
            <para>Copy one or more files in a working copy or in the
              repository.  When copying multiple sources, they will be
              added as children of <replaceable>DST</replaceable>, which  
must be a directory.
              <replaceable>SRC</replaceable> and
              <replaceable>DST</replaceable> can each be either a
              working copy (WC) path or URL:</para>
-
+
              <variablelist>

                <varlistentry>
@@ -1652,7 +1663,7 @@
            <para>Copy an item from the repository to your working
              copy (this just schedules the copy—nothing goes into the
              repository until you commit):</para>
-
+
            <screen>
  $ svn copy file:///var/svn/repos/test/far-away -r 6 near-here
  A         near-here
@@ -1766,7 +1777,7 @@
  --with-revprop ARG
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>

@@ -1808,7 +1819,7 @@
  $ svn delete --force over-there
  D         over-there
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -2093,7 +2104,7 @@
              <replaceable>CMD</replaceable> <option>-x</option> to
              pass arguments directly to the external diff
              program:</para>
-
+
            <screen>
  $ svn diff --diff-cmd /usr/bin/diff -x "-i -b" COMMITTERS
  Index: COMMITTERS
@@ -2107,7 +2118,7 @@
              along with the <option>--summarize</option> option to view
              XML describing the changes that occurred between
              revisions, but not the contents of the diff itself:</para>
-
+
            <screen>
  $ svn diff --summarize --xml http://svn.red-bean.com/repos/test@r2 \
             http://svn.red-bean.com/repos/test
@@ -2270,7 +2281,7 @@
            <para>This is your best friend when you're using
              Subversion and this book isn't within reach!</para>
          </refsect1>
-
+
          <refsect1>
            <title>Alternate names</title>
            <para><command>?</command>, <command>h</command></para>
@@ -2400,7 +2411,7 @@
              <emphasis>not</emphasis> under version control.  To start
              working, you still need to <command>svn checkout</command>
              a fresh working copy of the tree.</para>
-
+
          </refsect1>
        </refentry>

@@ -3124,7 +3135,7 @@
                either run the log operation against the repository's
                root URL, or specify a path that you happen to know was
                changed in that revision:</para>
-
+
              <screen>
  $ svn log -r 20 touched.txt
  ------------------------------------------------------------------------
@@ -3272,7 +3283,7 @@
  Transmitting file data ..
  Committed revision 391.
  </screen>
-
+
          <para>To merge changes to a single file:</para>

          <screen>
@@ -3791,7 +3802,7 @@

            <para>Examine a property of a file in your working
              copy:</para>
-
+
            <screen>
  $ svn propget svn:keywords foo.c
  Author
@@ -3822,7 +3833,7 @@
  </target>
  </properties>
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -3883,7 +3894,7 @@
  --xml
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>

@@ -3925,7 +3936,7 @@
  </target>
  </properties>
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -4037,7 +4048,7 @@

            <para>Or, if you don't have a working copy, you can
              provide a URL:</para>
-
+
            <screen>
  $ svn propset --revprop -r 26 svn:log "Document nap." \
                http://svn.red-bean.com/repos
@@ -4173,10 +4184,10 @@
  --targets FILENAME
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>
-
+
            <para>Here's an example where, after a postponed conflict
              resolution during update, <command>svn resolve</command>
              replaces the all conflicts in
@@ -4258,10 +4269,10 @@
  --targets FILENAME
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>
-
+
            <para>If you get a conflict on an update, your working
              copy will sprout three new files:</para>

@@ -4437,12 +4448,12 @@
            <para>The first six columns in the output are each one
              character wide, and each column gives you information
              about different aspects of each working copy item.</para>
-
+
            <para>The first column indicates that an item
              was added, deleted, or otherwise changed:</para>

            <variablelist>
-
+
              <varlistentry>
                <term><literal>' '</literal></term>
                <listitem>
@@ -4537,7 +4548,7 @@
              directory's properties:</para>

            <variablelist>
-
+
              <varlistentry>
                <term><literal>' '</literal></term>
                <listitem>
@@ -4569,14 +4580,14 @@
              <xref linkend="svn.tour.cleanup"/>):</para>

            <variablelist>
-
+
              <varlistentry>
                <term><literal>' '</literal></term>
                <listitem>
                  <para>Item is not locked.</para>
                </listitem>
              </varlistentry>
-
+
              <varlistentry>
                <term><literal>'L'</literal></term>
                <listitem>
@@ -4588,16 +4599,16 @@

            <para>The fourth column is populated only if the item is
              scheduled for addition-with-history:</para>
-
+
            <variablelist>
-
+
              <varlistentry>
                <term><literal>' '</literal></term>
                <listitem>
                  <para>No history scheduled with commit.</para>
                </listitem>
              </varlistentry>
-
+
              <varlistentry>
                <term><literal>'+'</literal></term>
                <listitem>
@@ -4612,14 +4623,14 @@
              linkend="svn.branchmerge.switchwc"/>):</para>

            <variablelist>
-
+
              <varlistentry>
                <term><literal>' '</literal></term>
                <listitem>
                  <para>Item is a child of its parent directory.</para>
                </listitem>
              </varlistentry>
-
+
              <varlistentry>
                <term><literal>'S'</literal></term>
                <listitem>
@@ -4630,9 +4641,9 @@
            </variablelist>

            <para>The sixth column is populated with lock information:</para>
-
+
            <variablelist>
-
+
              <varlistentry>
                <term><literal>' '</literal></term>
                <listitem>
@@ -4650,7 +4661,7 @@
                  <para>File is locked in this working copy.</para>
                </listitem>
              </varlistentry>
-
+
              <varlistentry>
                <term>O</term>
                <listitem>
@@ -4691,14 +4702,14 @@
              <option>--show-updates</option> option):</para>

            <variablelist>
-
+
              <varlistentry>
                <term><literal>' '</literal></term>
                <listitem>
                  <para>The item in your working copy is up to date.</para>
                </listitem>
              </varlistentry>
-
+
              <varlistentry>
                <term><literal>'*'</literal></term>
                <listitem>
@@ -4713,11 +4724,11 @@
              delimited by spaces.  The working revision is the next
              field if the <option>--show-updates</option> or
              <option>--verbose</option> option is passed.</para>
-
+
            <para>If the <option>--verbose</option> option is passed,
              the last committed revision and last committed author
              are displayed next.</para>
-
+
            <para>The working copy path is always the final field, so
              it can include spaces.</para>

@@ -4945,7 +4956,7 @@
  --set-depth ARG
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>

@@ -5027,7 +5038,7 @@
              understand exactly when one should or shouldn't use
              <option>--relocate</option>.  Here's the rule of
              thumb:</para>
-
+
              <itemizedlist>
                <listitem><para>If the working copy needs to reflect a
                    new directory <emphasis>within</emphasis> the
@@ -5303,11 +5314,11 @@
                cat</command> instead—it won't change your working
                copy.</para>
            </tip>
-
+
          </refsect1>
        </refentry>
      </sect2>
-
+
    </sect1>

    <!-- =================================================================  
-->
@@ -5315,7 +5326,7 @@
    <!-- =================================================================  
-->
    <sect1 id="svn.ref.svnadmin">
      <title>svnadmin</title>
-
+
      <para><command>svnadmin</command> is the administrative tool for
        monitoring and repairing your Subversion repository.  For
        detailed information on repository administration, see the  
maintenance section for <xref
@@ -5324,16 +5335,16 @@
      <para>Since <command>svnadmin</command> works via direct repository  
access
        (and thus can only be used on the machine that holds the
        repository), it refers to the repository with a path, not a  
URL.</para>
-
+
      <!-- ===============================================================  
-->
      <sect2 id="svn.ref.svnadmin.sw">
        <title><command>svnadmin</command> Options</title>
-
+
        <para>Options in <command>svmadin</command> are global, just
          as they are in <command>svn</command>:</para>

        <variablelist>
-
+
          <varlistentry>
            <term><option>--bdb-log-keep</option></term>
            <listitem>
@@ -5343,7 +5354,7 @@
                catastrophic repository failure.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--bdb-txn-nosync</option></term>
            <listitem>
@@ -5356,7 +5367,7 @@
                speed but has some risks associated with it).</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--bypass-hooks</option></term>
            <listitem>
@@ -5544,7 +5555,7 @@
  </screen>

            <para>Exciting, isn't it?</para>
-
+
          </refsect1>
        </refentry>

@@ -5613,7 +5624,7 @@
            <screen>
  $ svnadmin create /var/svn/repos
  </screen>
-
+
            <para>In Subversion 1.0, a Berkeley DB repository is always
              created.  In Subversion 1.1, a Berkeley DB repository is
              the default repository type, but an FSFS repository can be
@@ -5659,7 +5670,7 @@
              </refsect1>
          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --quiet (-q)
  --revision (-r) REV
@@ -5736,7 +5747,7 @@
          </refsect1>
          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --deltas
  --incremental
@@ -5744,7 +5755,7 @@
  --revision (-r) REV
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>

@@ -5834,7 +5845,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --clean-logs
  </screen>
@@ -5918,7 +5929,7 @@

          <refsect1>
            <title>Examples</title>
-
+
            <para>Remove all unused logfiles from the repository:</para>

          <screen>
@@ -5961,7 +5972,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --force-uuid
  --ignore-uuid
@@ -6031,7 +6042,7 @@

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

@@ -6131,7 +6142,7 @@
          </refsect1>
          <refsect1>
            <title>Examples</title>
-
+
            <para>Recover a hung repository:</para>

            <screen>
@@ -6202,7 +6213,7 @@

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

@@ -6249,7 +6260,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --quiet (-q)
  </screen>
@@ -6511,7 +6522,7 @@

  Upgrade completed.
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -6549,7 +6560,7 @@
              didn't you?).</para>

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

@@ -6561,7 +6572,7 @@

          <refsect1>
            <title>Examples</title>
-
+
            <para>Verify a hung repository:</para>

            <screen>
@@ -6575,13 +6586,13 @@
      </sect2>

    </sect1>
-
+
    <!-- =================================================================  
-->
    <!-- =================================================================  
-->
    <!-- =================================================================  
-->
    <sect1 id="svn.ref.svnlook">
      <title>svnlook</title>
-
+
      <para><command>svnlook</command> is a command-line utility for
        examining different aspects of a Subversion repository.  It
        does not make any changes to the repository—it's just
@@ -6597,11 +6608,11 @@
      <para>If no revision or transaction is specified,
        <command>svnlook</command> defaults to the youngest (most
        recent) revision of the repository.</para>
-
+
      <!-- ===============================================================  
-->
      <sect2 id="svn.ref.svnlook.sw">
        <title>svnlook Options</title>
-
+
        <para>Options in <command>svnlook</command> are global, just
          as they are in <command>svn</command> and
          <command>svnadmin</command>; however, most options apply
@@ -6640,7 +6651,7 @@
              existing (empty) file.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--revision</option>
              (<option>-r</option>)</term>
@@ -6714,7 +6725,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --revision (-r) REV
  --transaction (-t) TXN
@@ -6789,7 +6800,7 @@
     III. PARTICIPATING IN THE SUBVERSION COMMUNITY
  …
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -6818,7 +6829,7 @@
              columns:</para>

            <variablelist>
-
+
              <varlistentry>
                <term><literal>'A '</literal></term>
                <listitem>
@@ -6948,10 +6959,10 @@
  --transaction (-t) TXN
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>
-
+
            <para>This shows the date of revision 40 of a test
              repository:</para>

@@ -6988,7 +6999,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --diff-copy-from
  --no-diff-added
@@ -7000,7 +7011,7 @@

          <refsect1>
            <title>Examples</title>
-
+
            <para>This shows a newly added (empty) file, a deleted
              file, and a copied file:</para>

@@ -7028,7 +7039,7 @@
  Deleted: trunk/vendors/deli/pickle.txt
   
==============================================================================
  </screen>
-
+
            <para>If a file has a nontextual
              <literal>svn:mime-type</literal> property, the
              differences are not explicitly shown.</para>
@@ -7078,7 +7089,7 @@
  $ svnlook dirs-changed -r 40 /var/svn/repos
  trunk/vendors/deli/
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -7179,7 +7190,7 @@
         2   /trunk <1.0.r2/295>
         1   /trunk <1.0.r1/532>
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -7229,7 +7240,7 @@
  16
  Rearrange lunch.
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -7262,7 +7273,7 @@

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

@@ -7281,7 +7292,7 @@
  Comment (1 line):
  Rework the uppermost branches on the bald cypress in the foreground.
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -7311,16 +7322,16 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --revision (-r) REV
  --transaction (-t) TXN
  </screen>
          </refsect1>
-
+
          <refsect1>
            <title>Examples</title>
-
+
            <para>This shows the log output for revision 40 in our sample
              repository:</para>

@@ -7328,7 +7339,7 @@
  $ svnlook log /var/svn/repos/
  Rearrange lunch.
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -7449,7 +7460,7 @@
    original-author : harry
    svn:mime-type : text/plain
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -7490,7 +7501,7 @@

          <refsect1>
            <title>Example</title>
-
+
            <para>This shows the tree output (with nodeIDs) for revision
              13 in our sample repository:</para>

@@ -7507,7 +7518,7 @@
     Makefile <3.0.r7/41>
     integer.c <4.1.r13/109>
  </screen>
-
+
          </refsect1>
        </refentry>

@@ -7605,7 +7616,7 @@
    <sect1 id="svn.ref.svnsync">

      <title>svnsync</title>
-
+
      <para><command>svnsync</command> is the Subversion remote
        repository mirroring tool.  Put simply, it allows you to replay
        the revisions of one repository into another one.</para>
@@ -7702,7 +7713,7 @@
                information as needed.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--sync-password</option>
              <replaceable>PASSWD</replaceable></term>
@@ -7713,7 +7724,7 @@
                information as needed.</para>
            </listitem>
          </varlistentry>
-
+
          <varlistentry>
            <term><option>--sync-username</option>
              <replaceable>NAME</replaceable></term>
@@ -7831,7 +7842,7 @@
              and you'd like to sync a copy of your repository over to
              the backup server that Ira The Knife is running over in
              cell block D.</para>
-
+
          </refsect1>

          <refsect1>
@@ -8017,7 +8028,7 @@
    <sect1 id="svn.ref.svnserve">

      <title>svnserve</title>
-
+
      <para><command>svnserve</command> allows access to Subversion
        repositories using Subversion's custom network protocol.</para>

@@ -8039,11 +8050,11 @@
        policies to apply.  See <xref
        linkend="svn.serverconfig.svnserve"/> for details of the
        <filename>svnserve.conf</filename> file.</para>
-
+
      <!-- ===============================================================  
-->
      <sect2 id="svn.ref.svnserve.sw">
        <title>svnserve Options</title>
-
+
        <para>Unlike the previous commands we've
          described, <command>svnserve</command> has no
          subcommands—it is controlled exclusively by
@@ -8202,7 +8213,7 @@
    <!-- =================================================================  
-->
    <sect1 id="svn.ref.svndumpfilter">
      <title>svndumpfilter</title>
-
+
      <para><command>svndumpfilter</command> is a command-line utility
        for removing history from a Subversion dump file by either
        excluding or including paths beginning with one or more named
@@ -8212,7 +8223,7 @@
      <!-- ===============================================================  
-->
      <sect2 id="svn.ref.svndumpfilter.options">
        <title>svndumpfilter Options</title>
-
+
        <para>Options in <command>svndumpfilter</command> are global, just
          as they are in <command>svn</command> and
          <command>svnadmin</command>:</para>
@@ -8306,7 +8317,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --drop-empty-revs
  --preserve-revprops
@@ -8370,7 +8381,7 @@

          <refsect1>
            <title>Options</title>
-
+
            <screen>
  --drop-empty-revs
  --preserve-revprops
@@ -8450,7 +8461,7 @@
    <sect1 id="svn.ref.svnversion">

      <title>svnversion</title>
-
+
      <refentry id="svn.ref.svnversion.re">

        <indexterm>
@@ -8478,7 +8489,7 @@

          <para>It's common to use this output in your build process
            when defining the version number of your program.</para>
-
+
          <para><replaceable>TRAIL_URL</replaceable>, if present, is the
            trailing portion of the URL used to determine whether
            <replaceable>WC_PATH</replaceable> itself is switched
@@ -8491,7 +8502,7 @@
            <replaceable>TRAIL_URL</replaceable> cannot be defined if
            <replaceable>WC_PATH</replaceable> is not explicitly
            given.</para>
-
+
        </refsect1>

        <refsect1 id="svn.ref.svnversion.re.sw">
@@ -8502,14 +8513,14 @@
            options:</para>

          <variablelist>
-
+
            <varlistentry>
              <term><option>--no-newline</option>  
(<option>-n</option>)</term>
              <listitem>
                <para>Omits the usual trailing newline from the  
output.</para>
              </listitem>
            </varlistentry>
-
+
            <varlistentry>
              <term><option>--committed</option> (<option>-c</option>)</term>
              <listitem>
@@ -8517,14 +8528,14 @@
                current (i.e., highest locally available) revisions.</para>
              </listitem>
            </varlistentry>
-
+
            <varlistentry>
              <term><option>--help</option> (<option>-h</option>)</term>
              <listitem>
                <para>Prints a help summary.</para>
              </listitem>
            </varlistentry>
-
+
            <varlistentry>
              <term><option>--version</option></term>
              <listitem>
@@ -8610,7 +8621,7 @@
    <sect1 id="svn.ref.mod_dav_svn">

      <title>mod_dav_svn</title>
-
+
      <refentry id="svn.ref.mod_dav_svn.conf">
        <refnamediv>

@@ -8638,7 +8649,7 @@
            that apply to <command>mod_dav_svn</command>:</para>

          <variablelist>
-
+
            <varlistentry>
              <term><literal>DAV svn</literal></term>
              <listitem>
@@ -8865,7 +8876,7 @@

        <refsect1 id="svn.ref.mod_dav_svn.conf.logging">
          <title>High-level logging</title>
-
+
          <para>This is a list of Subversion action log messages
            produced by Apache's high-level logging mechanism, followed
            by an example of the log message.  See <xref
@@ -9004,7 +9015,7 @@
    <sect1 id="svn.ref.mod_authz_svn">

      <title>mod_authz_svn</title>
-
+
      <refentry id="svn.ref.mod_authz_svn.conf">
        <refnamediv>

@@ -9032,7 +9043,7 @@
            that apply to <command>mod_authz_svn</command>:</para>

          <variablelist>
-
+
            <varlistentry>
              <term><literal>AuthzSVNAccessFile
                <replaceable>file-path</replaceable></literal></term>
@@ -9301,14 +9312,14 @@
    <!-- =================================================================  
-->
    <!-- =================================================================  
-->
    <sect1 id="svn.ref.reposhooks">
-
+
      <title>Repository Hooks</title>

      <para>These are the repository hooks that Subversion provides:</para>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.start-commit">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9322,7 +9333,7 @@

        <refsect1>
          <title>Description</title>
-
+
          <para>The start-commit hook is run before the commit
            transaction is even created.  It is typically used to
            decide whether the user has commit privileges at all.</para>
@@ -9339,7 +9350,7 @@

          <para>The command-line arguments passed to the hook program,
            in order, are:</para>
-
+
          <orderedlist>
            <listitem>
              <para>Repository path</para>
@@ -9356,7 +9367,7 @@
            </listitem>
          </orderedlist>
        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>

@@ -9368,10 +9379,10 @@
        </refsect1>

      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.pre-commit">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9416,17 +9427,17 @@
            </listitem>
          </orderedlist>
        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Change validation and control</para>
        </refsect1>
-
+
      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.post-commit">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9454,7 +9465,7 @@
            completed.  However, anything that the hook printed
            to <filename>stderr</filename> will be marshalled back to the
            client, making it easier to diagnose hook failures.</para>
-
+
        </refsect1>

        <refsect1>
@@ -9462,7 +9473,7 @@

          <para>The command-line arguments passed to the hook program,
            in order, are:</para>
-
+
          <orderedlist>
            <listitem>
              <para>Repository path</para>
@@ -9472,17 +9483,17 @@
            </listitem>
          </orderedlist>
        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Commit notification; tool integration</para>
        </refsect1>
-
+
      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.pre-revprop-change">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9544,17 +9555,17 @@
             input.</para>

        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Access control; change validation and control</para>
        </refsect1>
-
+
      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.post-revprop-change">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9594,7 +9605,7 @@

          <para>The command-line arguments passed to the hook program,
            in order, are:</para>
-
+
          <orderedlist>
            <listitem>
              <para>Repository path</para>
@@ -9619,17 +9630,17 @@
            standard input, the previous value of the property.</para>

        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Property change notification</para>
        </refsect1>
-
+
      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.pre-lock">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9664,7 +9675,7 @@

          <para>The command-line arguments passed to the hook program,
            in order, are:</para>
-
+
          <orderedlist>
            <listitem>
              <para>Repository path</para>
@@ -9678,17 +9689,17 @@
            </listitem>
          </orderedlist>
        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Access control</para>
        </refsect1>
-
+
      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.post-lock">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9721,7 +9732,7 @@

          <para>The command-line arguments passed to the hook program,
            in order, are:</para>
-
+
          <orderedlist>
            <listitem>
              <para>Repository path</para>
@@ -9736,17 +9747,17 @@
            hook program via standard input, one path per line.</para>

        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Lock notification</para>
        </refsect1>
-
+
      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.pre-unlock">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9782,7 +9793,7 @@

          <para>The command-line arguments passed to the hook program,
            in order, are:</para>
-
+
          <orderedlist>
            <listitem>
              <para>Repository path</para>
@@ -9796,17 +9807,17 @@
            </listitem>
          </orderedlist>
        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Access control</para>
        </refsect1>
-
+
      </refentry>
-
+
      <!-- ===============================================================  
-->
      <refentry id="svn.ref.reposhooks.post-unlock">
-
+
        <indexterm>
          <primary>repository</primary>
          <secondary>hooks</secondary>
@@ -9839,7 +9850,7 @@

          <para>The command-line arguments passed to the hook program,
            in order, are:</para>
-
+
          <orderedlist>
            <listitem>
              <para>Repository path</para>
@@ -9854,15 +9865,15 @@
            hook program via standard input, one path per line.</para>

        </refsect1>
-
+
        <refsect1>
          <title>Common uses</title>
          <para>Unlock notification</para>
        </refsect1>
-
+
      </refentry>
    </sect1>
-
+
  </chapter>

  <!--


More information about the svnbook-dev mailing list