[svnbook] r4344 committed - Document new --show-inherited-props option for...

[svnbook at googlecode.com]

Revision: 4344
Author:   ptburba
Date:     Mon Jan 21 07:56:05 2013
Log:      Document new --show-inherited-props option for
'svnlook (pg|pl)' subcommands.

* en/book/ch09-reference.xml

   (svn.ref.svnlook.sw): Add
    svn.ref.svnlook.sw.show_inherited_props to valid
    svnlook options.

   (svn.ref.svnlook.c.propget,
    svn.ref.svnlook.c.proplist): Add --show-inherited-props
    as a valid option and give brief examples.

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

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

=======================================
--- /trunk/en/book/ch09-reference.xml	Fri Jan 18 07:20:24 2013
+++ /trunk/en/book/ch09-reference.xml	Mon Jan 21 07:56:05 2013
@@ -8057,6 +8057,15 @@
            </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>
@@ -8890,6 +8899,7 @@
              <screen>
  <xref linkend="svn.ref.svnlook.sw.revision" />
  <xref linkend="svn.ref.svnlook.sw.revprop" />
+<xref linkend="svn.ref.svnlook.sw.show_inherited_props" />
  <xref linkend="svn.ref.svnlook.sw.transaction" />
  </screen>
            </informalexample>
@@ -8909,6 +8919,22 @@
  </screen>
            </informalexample>

+          <para>This shows the inherited values of the <literal>
+            svn:auto-props</literal> property on the directory
+            <filename>/trunk</filename> in revision 14:</para>
+
+          <informalexample>
+            <screen>
+$ svnlook pg repos svn:auto-props trunk --show-inherited-props -v -r14
+Inherited properties on '/trunk',
+from '/':
+  svn:auto-props
+    *.py = svn:eol-style=native
+    *.c = svn:eol-style=native
+    *.h = svn:eol-style=native
+</screen>
+          </informalexample>
+
          </refsect1>
        </refentry>

@@ -8946,6 +8972,7 @@
              <screen>
  <xref linkend="svn.ref.svnlook.sw.revision" />
  <xref linkend="svn.ref.svnlook.sw.revprop" />
+<xref linkend="svn.ref.svnlook.sw.show_inherited_props" />
  <xref linkend="svn.ref.svnlook.sw.transaction" />
  <xref linkend="svn.ref.svnlook.sw.verbose" />
  <xref linkend="svn.ref.svnlook.sw.xml" />
@@ -8978,7 +9005,29 @@
    svn:mime-type : text/plain
  </screen>
            </informalexample>
-
+
+          <para>This shows the properties inherited by a directory:
+            </para>
+
+          <informalexample>
+            <screen>
+$ svnlook pl /var/svn/repos branches --show-inherited-props -v
+Inherited properties on '/branches',
+from '/':
+  svn:auto-props
+    *.py = svn:eol-style=native
+    *.c = svn:eol-style=native
+    *.h = svn:eol-style=native
+
+  svn:global-ignores
+    *.diff
+    *.patch
+
+Properties on '/branches':
+
+</screen>
+          </informalexample>
+
          </refsect1>
        </refentry>