[svnbook] r3928 committed - Some reference chapter updates for issue #32 ("Document new 1.6...

svnbook at googlecode.com svnbook at googlecode.com
Thu Jul 28 11:45:31 CDT 2011


Revision: 3928
Author:   cmpilato at gmail.com
Date:     Thu Jul 28 09:44:53 2011
Log:      Some reference chapter updates for issue #32 ("Document new 1.6
subcommands and options").

* src/en/book/ch09-reference.xml
   (svn.ref.svn.sw): Describe '--with-no-revprops' switch, and rework
     the description of '--with-all-revprops'.
   (svn.ref.svn.c.log): Mention the 'svn log' also accepts  
--with-no-revprops.
   (svn.ref.svn.c.propget): Add an example which uses --verbose.
   (svn.ref.svnadmin.sw): Describe '--pre-1.6-compatible' switch.
   (svn.ref.svndumpfilter.sw): Describe the '--targets' switch.
   (svn.ref.svndumpfilter.commands.c.exclude,
    svn.ref.svndumpfilter.commands.c.include): Mention '--targets'.

http://code.google.com/p/svnbook/source/detail?r=3928

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

=======================================
--- /trunk/src/en/book/ch09-reference.xml	Thu Jul 28 08:28:00 2011
+++ /trunk/src/en/book/ch09-reference.xml	Thu Jul 28 09:44:53 2011
@@ -710,12 +710,25 @@
          <varlistentry>
            <term><option>--with-all-revprops</option></term>
            <listitem>
-            <para>Used with the <option>--xml</option> option to  
<command>svn log</command>,
-            will retrieve and display all revision
-            properties in the log output.</para>
+            <para>Used with the <option>--xml</option> option
+            to <command>svn log</command>, instructs Subversion to
+            retrieve and display all revision properties—the
+            standard ones used internally by Subversion as well as any
+            user-defined ones—in the log output.</para>
            </listitem>
          </varlistentry>

+        <varlistentry>
+          <term><option>--with-no-revprops</option></term>
+          <listitem>
+            <para>Used with the <option>--xml</option> option
+            to <command>svn log</command>, instructs Subversion to
+            omit all revision properties—including the standard
+            log message, author, and revision datestamp—from the
+            log output.</para>
+          </listitem>
+        </varlistentry>
+
          <varlistentry>
            <term><option>--with-revprop</option>
              <replaceable>ARG</replaceable></term>
@@ -3180,6 +3193,7 @@
  --use-merge-history (-g)
  --verbose (-v)
  --with-all-revprops
+--with-no-revprops
  --with-revprop ARG
  --xml
  </screen>
@@ -4174,6 +4188,21 @@
  </screen>
            </informalexample>

+          <para>For a more structured display of properties, use
+            the <option>--verbose</option> (<option>-v</option>)
+            option:</para>
+
+          <informalexample>
+            <screen>
+$ svn propget svn:keywords foo.c --verbose
+Properties on 'foo.c':
+  svn:keywords
+    Author
+    Date
+    Rev
+</screen>
+          </informalexample>
+
            <para>Lastly, you can get <command>svn propget</command>
              output in XML format with the <option>--xml</option>
              option:</para>
@@ -4192,7 +4221,7 @@
  </properties>
  </screen>
            </informalexample>
-
+
          </refsect1>
        </refentry>

@@ -5904,6 +5933,15 @@
            </listitem>
          </varlistentry>

+        <varlistentry>
+          <term><option>--pre-1.6-compatible</option></term>
+          <listitem>
+            <para>When creating a new repository, use a format that is
+              compatible with versions of Subversion earlier than
+              Subversion 1.6.</para>
+          </listitem>
+        </varlistentry>
+
          <varlistentry>
            <term><option>--revision</option> (<option>-r</option>)
            <replaceable>ARG</replaceable></term>
@@ -8984,6 +9022,21 @@
            </listitem>
          </varlistentry>

+        <varlistentry>
+          <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>
            <term><option>--quiet</option></term>
            <listitem>
@@ -9036,6 +9089,7 @@
  --quiet
  --renumber-revs
  --skip-missing-merge-sources
+--targets ARG
  </screen>
            </informalexample>
          </refsect1>
@@ -9104,6 +9158,7 @@
  --quiet
  --renumber-revs
  --skip-missing-merge-sources
+--targets ARG
  </screen>
            </informalexample>
          </refsect1>




More information about the svnbook-dev mailing list