[svnbook] r4426 committed - * en/book/ref-svndumpfilter.xml,...
svnbook at googlecode.com
svnbook at googlecode.com
Tue Feb 12 13:36:07 CST 2013
Revision: 4426
Author: cmpilato at gmail.com
Date: Tue Feb 12 11:35:59 2013
Log: * en/book/ref-svndumpfilter.xml,
* en/book/ref-svnlook.xml
Indentation/whitespace/comment tweaks only.
http://code.google.com/p/svnbook/source/detail?r=4426
Modified:
/trunk/en/book/ref-svndumpfilter.xml
/trunk/en/book/ref-svnlook.xml
=======================================
--- /trunk/en/book/ref-svndumpfilter.xml Thu Feb 7 12:43:50 2013
+++ /trunk/en/book/ref-svndumpfilter.xml Tue Feb 12 11:35:59 2013
@@ -3,9 +3,6 @@
<reference id="svn.ref.svndumpfilter">
<title>svndumpfilter Reference—Subversion History Filtering</title>
- <!-- =================================================================
-->
- <!-- =================================================================
-->
- <!-- =================================================================
-->
<partintro>
<para><command>svndumpfilter</command> is a command-line utility
@@ -14,121 +11,119 @@
prefixes. For details, see
<xref linkend="svn.reposadmin.maint.tk.svndumpfilter"/>.</para>
- <para>Options in <command>svndumpfilter</command> are global, just
- as they are in <command>svn</command> and
- <command>svnadmin</command>:</para>
+ <para>Options in <command>svndumpfilter</command> are global, just
+ as they are in <command>svn</command> and
+ <command>svnadmin</command>:</para>
- <variablelist id="svn.ref.svndumpfilter.sw">
- <title>svndumpfilter Options</title>
+ <variablelist id="svn.ref.svndumpfilter.sw">
+ <title>svndumpfilter Options</title>
- <varlistentry id="svn.ref.svndumpfilter.sw.drop_empty_revs">
- <term><option>--drop-empty-revs</option></term>
- <listitem>
- <para>If filtering causes any revision to be empty (i.e.,
- causes no change to the repository), removes these
- revisions from the final dump file.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svndumpfilter.sw.drop_empty_revs">
+ <term><option>--drop-empty-revs</option></term>
+ <listitem>
+ <para>If filtering causes any revision to be empty (i.e.,
+ causes no change to the repository), removes these
+ revisions from the final dump file.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svndumpfilter.sw.pattern">
- <term><option>--pattern</option></term>
- <listitem>
- <para>Treat the path prefixes provided to the filtering
- commands as file glob patterns rather than explicit path
- substrings.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svndumpfilter.sw.pattern">
+ <term><option>--pattern</option></term>
+ <listitem>
+ <para>Treat the path prefixes provided to the filtering
+ commands as file glob patterns rather than explicit path
+ substrings.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svndumpfilter.sw.renumber_revs">
- <term><option>--renumber-revs</option></term>
- <listitem>
- <para>Renumbers revisions that remain after
- filtering.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svndumpfilter.sw.renumber_revs">
+ <term><option>--renumber-revs</option></term>
+ <listitem>
+ <para>Renumbers revisions that remain after
+ filtering.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry
id="svn.ref.svndumpfilter.sw.skip_missing_merge_sources">
- <term><option>--skip-missing-merge-sources</option></term>
- <listitem>
- <para>Skips merge sources that have been removed as part of
- the filtering. Without this
- option, <command>svndumpfilter</command> will exit with
- an error if the merge source for a retained path is
- removed by filtering.</para>
- </listitem>
- </varlistentry>
+ <varlistentry
id="svn.ref.svndumpfilter.sw.skip_missing_merge_sources">
+ <term><option>--skip-missing-merge-sources</option></term>
+ <listitem>
+ <para>Skips merge sources that have been removed as part of
+ the filtering. Without this
+ option, <command>svndumpfilter</command> will exit with
+ an error if the merge source for a retained path is
+ removed by filtering.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svndumpfilter.sw.preserve_revprops">
- <term><option>--preserve-revprops</option></term>
- <listitem>
- <para>If all nodes in a revision are removed by filtering
- and <option>--drop-empty-revs</option> is not passed,
- the default behavior of <command>svndumpfilter</command>
- is to remove all revision properties except for the date
- and the log message (which will merely indicate that the
- revision is empty). Passing this option will preserve
- existing revision properties (which may or may not make
- sense since the related content is no longer present in
- the dump file).</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svndumpfilter.sw.preserve_revprops">
+ <term><option>--preserve-revprops</option></term>
+ <listitem>
+ <para>If all nodes in a revision are removed by filtering
+ and <option>--drop-empty-revs</option> is not passed,
+ the default behavior of <command>svndumpfilter</command>
+ is to remove all revision properties except for the date
+ and the log message (which will merely indicate that the
+ revision is empty). Passing this option will preserve
+ existing revision properties (which may or may not make
+ sense since the related content is no longer present in
+ the dump file).</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svndumpfilter.sw.targets">
- <term><option>--targets</option>
<replaceable>FILENAME</replaceable></term>
- <listitem>
- <para>Instructs <command>svndumpfilter</command> to read
- additional path prefixes—one per line—from
- the file located at <replaceable>FILENAME</replaceable>.
- This is especially useful for complex filtering
- operations which require more prefixes than the
- operating system allows to be specified on a single
- command line.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="svn.ref.svndumpfilter.sw.quiet">
- <term><option>--quiet</option></term>
- <listitem>
- <para>Does not display filtering statistics.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svndumpfilter.sw.targets">
+ <term><option>--targets</option>
<replaceable>FILENAME</replaceable></term>
+ <listitem>
+ <para>Instructs <command>svndumpfilter</command> to read
+ additional path prefixes—one per line—from
+ the file located at <replaceable>FILENAME</replaceable>.
+ This is especially useful for complex filtering
+ operations which require more prefixes than the
+ operating system allows to be specified on a single
+ command line.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svndumpfilter.sw.quiet">
+ <term><option>--quiet</option></term>
+ <listitem>
+ <para>Does not display filtering statistics.</para>
+ </listitem>
+ </varlistentry>
- </variablelist>
+ </variablelist>
</partintro>
- <!-- ===============================================================
-->
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svndumpfilter.commands.c.exclude">
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svndumpfilter.commands.c.exclude">
+ <indexterm>
+ <primary>svndumpfilter</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>exclude</tertiary>
+ </indexterm>
- <indexterm>
- <primary>svndumpfilter</primary>
- <secondary>subcommands</secondary>
- <tertiary>exclude</tertiary>
- </indexterm>
+ <refnamediv>
+ <refname>svndumpfilter exclude</refname>
+ <refpurpose>Filter out nodes with given prefixes from the dump
stream.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svndumpfilter exclude PATH_PREFIX...</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <refnamediv>
- <refname>svndumpfilter exclude</refname>
- <refpurpose>Filter out nodes with given prefixes from the dump
stream.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svndumpfilter exclude
PATH_PREFIX...</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <para>This can be used to exclude nodes that begin with one or
+ more <replaceable>PATH_PREFIX</replaceable>es from a
+ filtered dump file.</para>
+ </refsect1>
- <para>This can be used to exclude nodes that begin with one or
- more <replaceable>PATH_PREFIX</replaceable>es from a
- filtered dump file.</para>
- </refsect1>
+ <refsect1>
+ <title>Options</title>
- <refsect1>
- <title>Options</title>
-
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
<xref linkend="svn.ref.svndumpfilter.sw.drop_empty_revs" />
<xref linkend="svn.ref.svndumpfilter.sw.pattern" />
<xref linkend="svn.ref.svndumpfilter.sw.preserve_revprops" />
@@ -137,20 +132,20 @@
<xref linkend="svn.ref.svndumpfilter.sw.skip_missing_merge_sources" />
<xref linkend="svn.ref.svndumpfilter.sw.targets" />
</screen>
- </informalexample>
- </refsect1>
+ </informalexample>
+ </refsect1>
- <refsect1>
- <title>Examples</title>
+ <refsect1>
+ <title>Examples</title>
- <para>If we have a dump file from a repository with a number
- of different picnic-related directories in it, but we want
- to keep everything <emphasis>except</emphasis>
- the <filename>sandwiches</filename> part of the
- repository, we'll exclude only that path:</para>
+ <para>If we have a dump file from a repository with a number
+ of different picnic-related directories in it, but we want
+ to keep everything <emphasis>except</emphasis>
+ the <filename>sandwiches</filename> part of the
+ repository, we'll exclude only that path:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svndumpfilter exclude sandwiches < dumpfile > filtered-dumpfile
Excluding prefixes:
'/sandwiches'
@@ -165,18 +160,18 @@
'/sandwiches'
$
</screen>
- </informalexample>
+ </informalexample>
- <para>Beginning in Subversion 1.7,
- <command>svndumpfilter</command> can optionally treat
- the <replaceable>PATH_PREFIX</replaceable>s not merely as
- explicit substrings, but as file patterns instead. So,
- for example, if you wished to filter out paths which ended
- with <filename>.OLD</filename>, you would do the
- following:</para>
+ <para>Beginning in Subversion 1.7,
+ <command>svndumpfilter</command> can optionally treat
+ the <replaceable>PATH_PREFIX</replaceable>s not merely as
+ explicit substrings, but as file patterns instead. So,
+ for example, if you wished to filter out paths which ended
+ with <filename>.OLD</filename>, you would do the
+ following:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svndumpfilter exclude --pattern "*.OLD" < dumpfile >
filtered-dumpfile
Excluding prefix patterns:
'/*.OLD'
@@ -193,42 +188,42 @@
'/toppings/cheese.OLD'
$
</screen>
- </informalexample>
+ </informalexample>
- </refsect1>
- </refentry>
+ </refsect1>
+ </refentry>
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svndumpfilter.commands.c.include">
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svndumpfilter.commands.c.include">
- <indexterm>
- <primary>svndumpfilter</primary>
- <secondary>subcommands</secondary>
- <tertiary>include</tertiary>
- </indexterm>
+ <indexterm>
+ <primary>svndumpfilter</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>include</tertiary>
+ </indexterm>
- <refnamediv>
- <refname>svndumpfilter include</refname>
- <refpurpose>Filter out nodes without given prefixes from
- dump stream.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svndumpfilter include
PATH_PREFIX...</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <refnamediv>
+ <refname>svndumpfilter include</refname>
+ <refpurpose>Filter out nodes without given prefixes from
+ dump stream.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svndumpfilter include PATH_PREFIX...</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <para>Can be used to include nodes that begin with one or
- more <replaceable>PATH_PREFIX</replaceable>es in a
- filtered dump file (thus excluding all other paths).</para>
- </refsect1>
+ <para>Can be used to include nodes that begin with one or
+ more <replaceable>PATH_PREFIX</replaceable>es in a
+ filtered dump file (thus excluding all other paths).</para>
+ </refsect1>
- <refsect1>
- <title>Options</title>
+ <refsect1>
+ <title>Options</title>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
<xref linkend="svn.ref.svndumpfilter.sw.drop_empty_revs" />
<xref linkend="svn.ref.svndumpfilter.sw.pattern" />
<xref linkend="svn.ref.svndumpfilter.sw.preserve_revprops" />
@@ -237,19 +232,19 @@
<xref linkend="svn.ref.svndumpfilter.sw.skip_missing_merge_sources" />
<xref linkend="svn.ref.svndumpfilter.sw.targets" />
</screen>
- </informalexample>
- </refsect1>
+ </informalexample>
+ </refsect1>
- <refsect1>
- <title>Example</title>
+ <refsect1>
+ <title>Example</title>
- <para>If we have a dump file from a repository with a number of
- different picnic-related directories in it, but want to
- keep only the <filename>sandwiches</filename> part of the
- repository, we'll include only that path:</para>
+ <para>If we have a dump file from a repository with a number of
+ different picnic-related directories in it, but want to
+ keep only the <filename>sandwiches</filename> part of the
+ repository, we'll include only that path:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svndumpfilter include sandwiches < dumpfile > filtered-dumpfile
Including prefixes:
'/sandwiches'
@@ -275,18 +270,18 @@
'/toppings/lettuce'
$
</screen>
- </informalexample>
+ </informalexample>
- <para>Beginning in Subversion 1.7,
- <command>svndumpfilter</command> can optionally treat
- the <replaceable>PATH_PREFIX</replaceable>s not merely as
- explicit substrings, but as file patterns instead. So,
- for example, if you wished to include only paths which ended
- with <filename>ks</filename>, you would do the
- following:</para>
+ <para>Beginning in Subversion 1.7,
+ <command>svndumpfilter</command> can optionally treat
+ the <replaceable>PATH_PREFIX</replaceable>s not merely as
+ explicit substrings, but as file patterns instead. So,
+ for example, if you wished to include only paths which ended
+ with <filename>ks</filename>, you would do the
+ following:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svndumpfilter include --pattern "*ks" < dumpfile >
filtered-dumpfile
Including prefix patterns:
'/*ks'
@@ -311,44 +306,44 @@
'/toppings/lettuce'
$
</screen>
- </informalexample>
+ </informalexample>
- </refsect1>
- </refentry>
+ </refsect1>
+ </refentry>
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svndumpfilter.commands.c.help">
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svndumpfilter.commands.c.help">
- <indexterm>
- <primary>svndumpfilter</primary>
- <secondary>subcommands</secondary>
- <tertiary>help</tertiary>
- </indexterm>
+ <indexterm>
+ <primary>svndumpfilter</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>help</tertiary>
+ </indexterm>
- <refnamediv>
- <refname>svndumpfilter help</refname>
- <refpurpose>Help!</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svndumpfilter help
[SUBCOMMAND...]</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <refnamediv>
+ <refname>svndumpfilter help</refname>
+ <refpurpose>Help!</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svndumpfilter help [SUBCOMMAND...]</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <para>Displays the help message
- for <command>svndumpfilter</command>. Unlike other help
- commands documented in this chapter, there is no witty
- commentary for this help command. The authors of this
- book deeply regret the omission.</para>
- </refsect1>
+ <para>Displays the help message
+ for <command>svndumpfilter</command>. Unlike other help
+ commands documented in this chapter, there is no witty
+ commentary for this help command. The authors of this
+ book deeply regret the omission.</para>
+ </refsect1>
- <refsect1>
- <title>Options</title>
- <para>None</para>
- </refsect1>
+ <refsect1>
+ <title>Options</title>
+ <para>None</para>
+ </refsect1>
- </refentry>
+ </refentry>
</reference>
=======================================
--- /trunk/en/book/ref-svnlook.xml Thu Feb 7 12:43:50 2013
+++ /trunk/en/book/ref-svnlook.xml Tue Feb 12 11:35:59 2013
@@ -20,290 +20,293 @@
<command>svnlook</command> defaults to the youngest (most
recent) revision of the repository.</para>
- <para>Options in <command>svnlook</command> are global, just
- as they are in <command>svn</command> and
- <command>svnadmin</command>; however, most options apply
- to only one subcommand since the functionality of
- <command>svnlook</command> is (intentionally) limited in
- scope:</para>
+ <para>Options in <command>svnlook</command> are global, just
+ as they are in <command>svn</command> and
+ <command>svnadmin</command>; however, most options apply
+ to only one subcommand since the functionality of
+ <command>svnlook</command> is (intentionally) limited in
+ scope:</para>
- <variablelist id="svn.ref.svnlook.sw">
- <title>svnlook Options</title>
+ <variablelist id="svn.ref.svnlook.sw">
+ <title>svnlook Options</title>
- <varlistentry id="svn.ref.svnlook.sw.copy_info">
- <term><option>--copy-info</option></term>
- <listitem>
- <para>Causes <command>svnlook changed</command> to show
- detailed copy source information.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.copy_info">
+ <term><option>--copy-info</option></term>
+ <listitem>
+ <para>Causes <command>svnlook changed</command> to show
+ detailed copy source information.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.diff_copy_from">
- <term><option>--diff-copy-from</option></term>
- <listitem>
- <para>Print differences for copied items against the copy
- source.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.diff_copy_from">
+ <term><option>--diff-copy-from</option></term>
+ <listitem>
+ <para>Print differences for copied items against the copy
+ source.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.extensions">
- <term><option>--extensions</option> (<option>-x</option>)
<replaceable>ARG</replaceable></term>
- <listitem>
- <para>Specifies customizations which Subversion should
- make when performing difference calculations. Valid
- extensions include:</para>
- <variablelist>
- <varlistentry>
- <term><option>--ignore-space-change</option>
(<option>-b</option>)</term>
- <listitem>
- <para>Ignore changes in the amount of white space.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--ignore-all-space</option>
(<option>-w</option>)</term>
- <listitem>
- <para>Ignore all white space.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--ignore-eol-style</option></term>
- <listitem>
- <para>Ignore changes in EOL (end-of-line) style.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--show-c-function</option>
(<option>-p</option>)</term>
- <listitem>
- <para>Show C function names in the diff output.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--unified</option>
(<option>-u</option>)</term>
- <listitem>
- <para>Show three lines of unified diff context.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>The default value is <literal>-u</literal>.</para>
- <para>Note that when Subversion is configured to invoke an
- external diff command, the value of
- the <option>--extension</option> (<option>-x</option>)
- option isn't restricted to the previously mentioned
- options, but may be <emphasis>any</emphasis> additional
- arguments which Subversion should pass to that command.
- If you wish to pass multiple arguments, you must enclose
- all of them in quotes.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.extensions">
+ <term><option>--extensions</option> (<option>-x</option>)
+ <replaceable>ARG</replaceable></term>
+ <listitem>
+ <para>Specifies customizations which Subversion should
+ make when performing difference calculations. Valid
+ extensions include:</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>--ignore-space-change</option>
+ (<option>-b</option>)</term>
+ <listitem>
+ <para>Ignore changes in the amount of white space.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--ignore-all-space</option>
+ (<option>-w</option>)</term>
+ <listitem>
+ <para>Ignore all white space.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--ignore-eol-style</option></term>
+ <listitem>
+ <para>Ignore changes in EOL (end-of-line) style.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--show-c-function</option>
+ (<option>-p</option>)</term>
+ <listitem>
+ <para>Show C function names in the diff output.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--unified</option> (<option>-u</option>)</term>
+ <listitem>
+ <para>Show three lines of unified diff context.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>The default value is <literal>-u</literal>.</para>
+ <para>Note that when Subversion is configured to invoke an
+ external diff command, the value of
+ the <option>--extension</option> (<option>-x</option>)
+ option isn't restricted to the previously mentioned
+ options, but may be <emphasis>any</emphasis> additional
+ arguments which Subversion should pass to that command.
+ If you wish to pass multiple arguments, you must enclose
+ all of them in quotes.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.full_paths">
- <term><option>--full-paths</option></term>
- <listitem>
- <para>Causes <command>svnlook tree</command> to display
- full paths instead of hierarchical, indented path
- components.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.full_paths">
+ <term><option>--full-paths</option></term>
+ <listitem>
+ <para>Causes <command>svnlook tree</command> to display
+ full paths instead of hierarchical, indented path
+ components.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.limit">
- <term><option>--limit</option> (<option>-l</option>)
<replaceable>ARG</replaceable></term>
- <listitem>
- <para>Limit output to a maximum number of
- <replaceable>ARG</replaceable> items.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.limit">
+ <term><option>--limit</option> (<option>-l</option>)
+ <replaceable>ARG</replaceable></term>
+ <listitem>
+ <para>Limit output to a maximum number of
+ <replaceable>ARG</replaceable> items.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.no_diff_deleted">
- <term><option>--no-diff-deleted</option></term>
- <listitem>
- <para>Prevents <command>svnlook diff</command> from printing
- differences for deleted files. The default behavior
- when a file is deleted in a transaction/revision is
- to print the same differences that you would see if
- you had left the file but removed all the content.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="svn.ref.svnlook.sw.no_diff_added">
- <term><option>--no-diff-added</option></term>
+ <varlistentry id="svn.ref.svnlook.sw.no_diff_deleted">
+ <term><option>--no-diff-deleted</option></term>
<listitem>
<para>Prevents <command>svnlook diff</command> from printing
- differences for added files. The default behavior when
- you add a file is to print the same differences that you
- would see if you had added the entire contents of an
- existing (empty) file.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="svn.ref.svnlook.sw.non_recursive">
- <term><option>--non-recursive</option>
(<option>-N</option>)</term>
- <listitem>
- <para>Operate on a single directory only.</para>
- </listitem>
- </varlistentry>
+ differences for deleted files. The default behavior
+ when a file is deleted in a transaction/revision is
+ to print the same differences that you would see if
+ you had left the file but removed all the content.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.revision">
- <term><option>--revision</option> (<option>-r</option>)</term>
- <listitem>
- <para>Specifies a particular revision number that you wish
- to examine.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.no_diff_added">
+ <term><option>--no-diff-added</option></term>
+ <listitem>
+ <para>Prevents <command>svnlook diff</command> from printing
+ differences for added files. The default behavior when
+ you add a file is to print the same differences that you
+ would see if you had added the entire contents of an
+ existing (empty) file.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnlook.sw.non_recursive">
+ <term><option>--non-recursive</option> (<option>-N</option>)</term>
+ <listitem>
+ <para>Operate on a single directory only.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnlook.sw.revision">
+ <term><option>--revision</option> (<option>-r</option>)</term>
+ <listitem>
+ <para>Specifies a particular revision number that you wish
+ to examine.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.revprop">
- <term><option>--revprop</option></term>
- <listitem>
- <para>Operates on a revision property instead of a
- property specific to a file or directory. This option
- requires that you also pass a revision with the
- <option>--revision</option> (<option>-r</option>)
- option.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.revprop">
+ <term><option>--revprop</option></term>
+ <listitem>
+ <para>Operates on a revision property instead of a
+ property specific to a file or directory. This option
+ requires that you also pass a revision with the
+ <option>--revision</option> (<option>-r</option>)
+ option.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.show_inherited_props">
- <term><option>--show-inherited-props</option></term>
- <listitem>
- <para>Works with <command>svnlook propget</command> and
- <command>svnlook proplist</command> to display the versioned
- properties inherited by a path.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.show_inherited_props">
+ <term><option>--show-inherited-props</option></term>
+ <listitem>
+ <para>Works with <command>svnlook propget</command> and
+ <command>svnlook proplist</command> to display the versioned
+ properties inherited by a path.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.transaction">
- <term><option>--transaction</option> (<option>-t</option>)</term>
- <listitem>
- <para>Specifies a particular transaction ID that you wish to
- examine.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.transaction">
+ <term><option>--transaction</option> (<option>-t</option>)</term>
+ <listitem>
+ <para>Specifies a particular transaction ID that you wish to
+ examine.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.show_ids">
- <term><option>--show-ids</option></term>
- <listitem>
- <para>Shows the filesystem node revision IDs for each path in
the filesystem
- tree.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.show_ids">
+ <term><option>--show-ids</option></term>
+ <listitem>
+ <para>Shows the filesystem node revision IDs for each path
+ in the filesystem tree.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.verbose">
- <term><option>--verbose</option> (<option>-v</option>)</term>
- <listitem>
- <para>Be verbose. When used with <command>svnlook
- proplist</command>, for example, this causes Subversion
- to display not just the list of properties, but their
- values also.</para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.verbose">
+ <term><option>--verbose</option> (<option>-v</option>)</term>
+ <listitem>
+ <para>Be verbose. When used with <command>svnlook
+ proplist</command>, for example, this causes Subversion
+ to display not just the list of properties, but their
+ values also.</para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="svn.ref.svnlook.sw.xml">
- <term><option>--xml</option></term>
- <listitem>
- <para></para>
- </listitem>
- </varlistentry>
+ <varlistentry id="svn.ref.svnlook.sw.xml">
+ <term><option>--xml</option></term>
+ <listitem>
+ <para></para>
+ </listitem>
+ </varlistentry>
- </variablelist>
+ </variablelist>
</partintro>
- <!-- ===============================================================
-->
-
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svnlook.c.author">
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svnlook.c.author">
- <indexterm>
- <primary>svnlook</primary>
- <secondary>subcommands</secondary>
- <tertiary>author</tertiary>
- </indexterm>
+ <indexterm>
+ <primary>svnlook</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>author</tertiary>
+ </indexterm>
- <refnamediv>
- <refname>svnlook author</refname>
- <refpurpose>Print the author.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svnlook author REPOS_PATH</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <refnamediv>
+ <refname>svnlook author</refname>
+ <refpurpose>Print the author.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svnlook author REPOS_PATH</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <para>Print the author of a revision or transaction in
- the repository.</para>
- </refsect1>
+ <para>Print the author of a revision or transaction in
+ the repository.</para>
+ </refsect1>
- <refsect1>
- <title>Options</title>
+ <refsect1>
+ <title>Options</title>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
<xref linkend="svn.ref.svnlook.sw.revision" />
<xref linkend="svn.ref.svnlook.sw.transaction" />
</screen>
- </informalexample>
- </refsect1>
+ </informalexample>
+ </refsect1>
- <refsect1>
- <title>Examples</title>
+ <refsect1>
+ <title>Examples</title>
- <para><command>svnlook author</command> is handy, but not
- very exciting:</para>
+ <para><command>svnlook author</command> is handy, but not
+ very exciting:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook author -r 40 /var/svn/repos
sally
</screen>
- </informalexample>
+ </informalexample>
- </refsect1>
- </refentry>
+ </refsect1>
+ </refentry>
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svnlook.c.cat">
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svnlook.c.cat">
- <indexterm>
- <primary>svnlook</primary>
- <secondary>subcommands</secondary>
- <tertiary>cat</tertiary>
- </indexterm>
+ <indexterm>
+ <primary>svnlook</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>cat</tertiary>
+ </indexterm>
- <refnamediv>
- <refname>svnlook cat</refname>
- <refpurpose>Print the contents of a file.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svnlook cat REPOS_PATH
PATH_IN_REPOS</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <refnamediv>
+ <refname>svnlook cat</refname>
+ <refpurpose>Print the contents of a file.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svnlook cat REPOS_PATH PATH_IN_REPOS</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <para>Print the contents of a file.</para>
+ <para>Print the contents of a file.</para>
- </refsect1>
+ </refsect1>
- <refsect1>
- <title>Options</title>
+ <refsect1>
+ <title>Options</title>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
<xref linkend="svn.ref.svnlook.sw.revision" />
<xref linkend="svn.ref.svnlook.sw.transaction" />
</screen>
- </informalexample>
- </refsect1>
+ </informalexample>
+ </refsect1>
- <refsect1>
- <title>Examples</title>
+ <refsect1>
+ <title>Examples</title>
- <para>This shows the contents of a file in transaction
- <literal>ax8</literal>, located at
- <filename>/trunk/README</filename>:</para>
+ <para>This shows the contents of a file in transaction
+ <literal>ax8</literal>, located
+ at <filename>/trunk/README</filename>:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook cat -t ax8 /var/svn/repos /trunk/README
Subversion, a version control system.
@@ -318,104 +321,104 @@
III. PARTICIPATING IN THE SUBVERSION COMMUNITY
…
</screen>
- </informalexample>
-
- </refsect1>
- </refentry>
+ </informalexample>
+
+ </refsect1>
+ </refentry>
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svnlook.c.changed">
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svnlook.c.changed">
- <indexterm>
- <primary>svnlook</primary>
- <secondary>subcommands</secondary>
- <tertiary>changed</tertiary>
- </indexterm>
+ <indexterm>
+ <primary>svnlook</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>changed</tertiary>
+ </indexterm>
- <refnamediv>
- <refname>svnlook changed</refname>
- <refpurpose>Print the paths that were changed.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svnlook changed REPOS_PATH</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <refnamediv>
+ <refname>svnlook changed</refname>
+ <refpurpose>Print the paths that were changed.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svnlook changed REPOS_PATH</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <para>Print the paths that were changed in a particular
- revision or transaction, as well as <quote>svn
- update-style</quote> status letters in the first two
- columns:</para>
+ <para>Print the paths that were changed in a particular
+ revision or transaction, as well as <quote>svn
+ update-style</quote> status letters in the first two
+ columns:</para>
- <variablelist>
-
- <varlistentry>
- <term><literal>'A '</literal></term>
- <listitem>
- <para>Item added to repository</para>
- </listitem>
- </varlistentry>
+ <variablelist>
+
+ <varlistentry>
+ <term><literal>'A '</literal></term>
+ <listitem>
+ <para>Item added to repository</para>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term><literal>'D '</literal></term>
- <listitem>
- <para>Item deleted from repository</para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term><literal>'D '</literal></term>
+ <listitem>
+ <para>Item deleted from repository</para>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term><literal>'U '</literal></term>
- <listitem>
- <para>File contents changed</para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term><literal>'U '</literal></term>
+ <listitem>
+ <para>File contents changed</para>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term><literal>'_U'</literal></term>
- <listitem>
- <para>Properties of item changed; note the leading
underscore</para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term><literal>'_U'</literal></term>
+ <listitem>
+ <para>Properties of item changed; note the leading
underscore</para>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term><literal>'UU'</literal></term>
- <listitem>
- <para>File contents and properties changed</para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term><literal>'UU'</literal></term>
+ <listitem>
+ <para>File contents and properties changed</para>
+ </listitem>
+ </varlistentry>
- </variablelist>
+ </variablelist>
- <para>Files and directories can be distinguished, as
- directory paths are displayed with a
- trailing <quote><literal>/</literal></quote>
- character.</para>
+ <para>Files and directories can be distinguished, as
+ directory paths are displayed with a
+ trailing <quote><literal>/</literal></quote>
+ character.</para>
- </refsect1>
+ </refsect1>
- <refsect1>
- <title>Options</title>
+ <refsect1>
+ <title>Options</title>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
<xref linkend="svn.ref.svnlook.sw.copy_info" />
<xref linkend="svn.ref.svnlook.sw.revision" />
<xref linkend="svn.ref.svnlook.sw.transaction" />
</screen>
- </informalexample>
- </refsect1>
+ </informalexample>
+ </refsect1>
- <refsect1>
- <title>Examples</title>
+ <refsect1>
+ <title>Examples</title>
- <para>This shows a list of all the changed files and
- directories in revision 39 of a test repository. Note
- that the first changed item is a directory, as evidenced
- by the trailing <literal>/</literal>:</para>
+ <para>This shows a list of all the changed files and
+ directories in revision 39 of a test repository. Note
+ that the first changed item is a directory, as evidenced
+ by the trailing <literal>/</literal>:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook changed -r 39 /var/svn/repos
A trunk/vendors/deli/
A trunk/vendors/deli/chips.txt
@@ -426,116 +429,116 @@
UU trunk/vendors/baker/pretzel.txt
D trunk/vendors/baker/baguette.txt
</screen>
- </informalexample>
+ </informalexample>
- <para>Here's an example that shows a revision in which a
- file was renamed:</para>
+ <para>Here's an example that shows a revision in which a
+ file was renamed:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook changed -r 64 /var/svn/repos
A trunk/vendors/baker/toast.txt
D trunk/vendors/baker/bread.txt
</screen>
- </informalexample>
+ </informalexample>
- <para>Unfortunately, nothing in the preceding output reveals
- the connection between the deleted and added files. Use
- the <option>--copy-info</option> option to make this
- relationship more apparent:</para>
+ <para>Unfortunately, nothing in the preceding output reveals
+ the connection between the deleted and added files. Use
+ the <option>--copy-info</option> option to make this
+ relationship more apparent:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook changed -r 64 --copy-info /var/svn/repos
A + trunk/vendors/baker/toast.txt
(from trunk/vendors/baker/bread.txt:r63)
D trunk/vendors/baker/bread.txt
</screen>
- </informalexample>
+ </informalexample>
- </refsect1>
- </refentry>
+ </refsect1>
+ </refentry>
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svnlook.c.date">
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svnlook.c.date">
- <indexterm>
- <primary>svnlook</primary>
- <secondary>subcommands</secondary>
- <tertiary>date</tertiary>
- </indexterm>
+ <indexterm>
+ <primary>svnlook</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>date</tertiary>
+ </indexterm>
- <refnamediv>
- <refname>svnlook date</refname>
- <refpurpose>Print the datestamp.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svnlook date REPOS_PATH</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <refnamediv>
+ <refname>svnlook date</refname>
+ <refpurpose>Print the datestamp.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svnlook date REPOS_PATH</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <para>Print the datestamp of a revision or transaction in
- a repository.</para>
- </refsect1>
+ <para>Print the datestamp of a revision or transaction in
+ a repository.</para>
+ </refsect1>
- <refsect1>
- <title>Options</title>
+ <refsect1>
+ <title>Options</title>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
<xref linkend="svn.ref.svnlook.sw.revision" />
<xref linkend="svn.ref.svnlook.sw.transaction" />
</screen>
- </informalexample>
- </refsect1>
-
- <refsect1>
- <title>Examples</title>
-
- <para>This shows the date of revision 40 of a test
- repository:</para>
+ </informalexample>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>This shows the date of revision 40 of a test
+ repository:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook date -r 40 /var/svn/repos/
2003-02-22 17:44:49 -0600 (Sat, 22 Feb 2003)
</screen>
- </informalexample>
+ </informalexample>
- </refsect1>
- </refentry>
+ </refsect1>
+ </refentry>
- <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
- <refentry id="svn.ref.svnlook.c.diff">
+ <!-- =============================================================== -->
+ <refentry id="svn.ref.svnlook.c.diff">
- <indexterm>
- <primary>svnlook</primary>
- <secondary>subcommands</secondary>
- <tertiary>diff</tertiary>
- </indexterm>
+ <indexterm>
+ <primary>svnlook</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>diff</tertiary>
+ </indexterm>
- <refnamediv>
- <refname>svnlook diff</refname>
- <refpurpose>Print differences of changed files and
properties.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><literal>svnlook diff REPOS_PATH</literal></para>
- </refsect1>
- <refsect1>
- <title>Description</title>
+ <refnamediv>
+ <refname>svnlook diff</refname>
+ <refpurpose>Print differences of changed files and
properties.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svnlook diff REPOS_PATH</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
- <para>Print GNU-style differences of changed files and
- properties in a repository.</para>
- </refsect1>
+ <para>Print GNU-style differences of changed files and
+ properties in a repository.</para>
+ </refsect1>
- <refsect1>
- <title>Options</title>
+ <refsect1>
+ <title>Options</title>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
<xref linkend="svn.ref.svnlook.sw.diff_copy_from" />
<xref linkend="svn.ref.svnlook.sw.no_diff_added" />
<xref linkend="svn.ref.svnlook.sw.no_diff_deleted" />
@@ -543,18 +546,18 @@
<xref linkend="svn.ref.svnlook.sw.transaction" />
<xref linkend="svn.ref.svnlook.sw.extensions" />
</screen>
- </informalexample>
- </refsect1>
+ </informalexample>
+ </refsect1>
- <refsect1>
- <title>Examples</title>
-
- <para>This shows a newly added (empty) file, a modified
- binary file, and a renamed (that is, copied and deleted)
- file with modifications:</para>
+ <refsect1>
+ <title>Examples</title>
+
+ <para>This shows a newly added (empty) file, a modified
+ binary file, and a renamed (that is, copied and deleted)
+ file with modifications:</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook diff -r 40 /var/svn/repos
Copied: trunk/relish.txt (from rev 39, trunk/vendors/deli/pickle.txt)
===================================================================
@@ -578,21 +581,21 @@
===================================================================
$
</screen>
- </informalexample>
+ </informalexample>
- <para>By default, <command>svnlook diff</command> will treat
- copied files very much like any other added file,
- displaying in their entirety the contents of the new file
- and merely using a different label to draw the copy/add
- distinction. However, you can use the
- <option>--diff-copy-from</option> option to cause
- <command>svnlook diff</command> to consider a copied
- file as worthy of mention only if it differs from the file
- from which it was copied, and to actually describe those
- differences.</para>
+ <para>By default, <command>svnlook diff</command> will treat
+ copied files very much like any other added file,
+ displaying in their entirety the contents of the new file
+ and merely using a different label to draw the copy/add
+ distinction. However, you can use the
+ <option>--diff-copy-from</option> option to cause
+ <command>svnlook diff</command> to consider a copied
+ file as worthy of mention only if it differs from the file
+ from which it was copied, and to actually describe those
+ differences.</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook diff -r 40 /var/svn/repos --diff-copy-from
Copied: trunk/relish.txt (from rev 39, trunk/vendors/deli/pickle.txt)
===================================================================
@@ -617,13 +620,13 @@
==============================================================================
$
</screen>
- </informalexample>
+ </informalexample>
- <para>Use the <option>--no-diff-deleted</option> option to
- silence output regarding deleted files.</para>
+ <para>Use the <option>--no-diff-deleted</option> option to
+ silence output regarding deleted files.</para>
- <informalexample>
- <screen>
+ <informalexample>
+ <screen>
$ svnlook diff -r 40 /var/svn/repos --no-diff-deleted
Copied: trunk/relish.txt (from rev 39, trunk/vendors/deli/pickle.txt)
===================================================================
@@ -640,212 +643,212 @@
==============================================================================
$
</screen>
- </informalexample>
-
- <para>Note that in each of the previous examples, when a
- file has a nontextual <literal>svn:mime-type</literal>
- property, the differences are not explicitly shown.</para>
+ </informalexample>
+
***The diff for this file has been truncated for email.***
More information about the svnbook-dev
mailing list