[svnbook] r4195 committed - * en/book/ch09-reference.xml...

svnbook at googlecode.com svnbook at googlecode.com
Thu Nov 10 14:37:28 CST 2011


Revision: 4195
Author:   cmpilato at gmail.com
Date:     Thu Nov 10 12:36:36 2011
Log:      * en/book/ch09-reference.xml
   Complete my read-thru of Chapter 9 (Reference), adding an example of
   'svnlook tree --full-paths' and documenting the svn:rdump-lock property.

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

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

=======================================
--- /trunk/en/book/ch09-reference.xml	Thu Nov 10 10:00:26 2011
+++ /trunk/en/book/ch09-reference.xml	Thu Nov 10 12:36:36 2011
@@ -8933,8 +8933,30 @@
          <refsect1>
            <title>Example</title>

-          <para>This shows the tree output (with nodeIDs) for revision
-            13 in our sample repository:</para>
+          <para>This shows the tree output for revision 13 in our
+            sample repository:</para>
+
+          <informalexample>
+            <screen>
+$ svnlook tree -r 13 /var/svn/repos
+/
+ trunk/
+  button.c
+  Makefile
+  integer.c
+ branches/
+  bookstore/
+   button.c
+   Makefile
+   integer.c
+…
+</screen>
+          </informalexample>
+
+          <para>Use the <option>--show-ids</option> option to include
+            node revision IDs (unique internal identifiers for
+            specific nodes in Subversion's versioned filesystem
+            implementation):</para>

            <informalexample>
              <screen>
@@ -8949,8 +8971,32 @@
     button.c <2.1.r12/85>
     Makefile <3.0.r7/41>
     integer.c <4.1.r13/109>
+…
  </screen>
            </informalexample>
+
+          <para>For output which lends itself more readily to being
+            parsed by scripts, use the <option>--full-paths</option>
+            option, which causes <command>svnlook</command> to print
+            the full repository path of each tree item and to not use
+            indentation to indicate hierarchy:</para>
+
+          <informalexample>
+            <screen>
+$ svnlook tree -r 13 /var/svn/repos --show-ids
+/ <0.0.r13/811>
+trunk/ <1.0.r9/551>
+trunk/button.c <2.0.r9/238>
+trunk/Makefile <3.0.r7/41>
+trunk/integer.c <4.0.r6/98>
+branches/ <5.0.r13/593>
+branches/bookstore/ <1.1.r13/390>
+branches/bookstore/button.c <2.1.r12/85>
+branches/bookstore/Makefile <3.0.r7/41>
+branches/bookstore/integer.c <4.1.r13/109>
+…
+</screen>
+          </informalexample>

          </refsect1>
        </refentry>
@@ -11491,6 +11537,21 @@
              <para>Contains the log message describing the
                revision.</para>

+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term><literal>svn:rdump-lock</literal></term>
+          <listitem>
+
+            <para>Used to temporarily enforce mutually exclusive
+              access to the repository by <command>svnrdump
+              load</command>.  This property is generally only
+              observed when such an operation is active—or when
+              an <command>svnrdump</command> command failed to cleanly
+              disconnect from the repository.  (This property is only
+              relevant when it appears on revision 0.)</para>
+
            </listitem>
          </varlistentry>





More information about the svnbook-dev mailing list