[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