[svnbook] r4434 committed - For issue 153 ("References: Consider using DocBook's <refsynopsisdiv>...

svnbook at googlecode.com svnbook at googlecode.com
Wed Feb 13 15:11:36 CST 2013


Revision: 4434
Author:   cmpilato at gmail.com
Date:     Wed Feb 13 13:11:19 2013
Log:      For issue 153 ("References: Consider using DocBook's  
<refsynopsisdiv>
and related markup") use <refsynopsisdiv> throughout the references.

* en/book/ref-reposhooks.xml,
* en/book/ref-svn.xml,
* en/book/ref-svnadmin.xml,
* en/book/ref-svndumpfilter.xml,
* en/book/ref-svnlook.xml,
* en/book/ref-svnmucc.xml,
* en/book/ref-svnrdump.xml,
* en/book/ref-svnserve.xml,
* en/book/ref-svnsync.xml,
* en/book/ref-svnversion.xml
   Use <refsynopsisdiv> throughout instead of a hardcoded <refsect1>
   with a <title>.  While here, consistify formatting of the reference
   entry front matter sections and divider comments.
http://code.google.com/p/svnbook/source/detail?r=4434

Modified:
  /trunk/en/book/ref-reposhooks.xml
  /trunk/en/book/ref-svn.xml
  /trunk/en/book/ref-svnadmin.xml
  /trunk/en/book/ref-svndumpfilter.xml
  /trunk/en/book/ref-svnlook.xml
  /trunk/en/book/ref-svnmucc.xml
  /trunk/en/book/ref-svnrdump.xml
  /trunk/en/book/ref-svnserve.xml
  /trunk/en/book/ref-svnsync.xml
  /trunk/en/book/ref-svnversion.xml

=======================================
--- /trunk/en/book/ref-reposhooks.xml	Tue Feb 12 08:47:37 2013
+++ /trunk/en/book/ref-reposhooks.xml	Wed Feb 13 13:11:19 2013
@@ -31,8 +31,10 @@
        Subversion workflow.</para>

    </partintro>
-
-  <!-- =============================================================== -->
+
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.start-commit">

      <indexterm>
@@ -53,6 +55,7 @@
          <replaceable>TXN-NAME</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -90,6 +93,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input Parameter(s)</title>

@@ -116,6 +120,7 @@
        </orderedlist>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>

@@ -128,7 +133,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.pre-commit">

      <indexterm>
@@ -147,6 +154,7 @@
          <replaceable>TXN-NAME</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -165,6 +173,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -193,6 +202,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Change validation and control</para>
@@ -200,7 +210,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.post-commit">

      <indexterm>
@@ -219,6 +231,7 @@
          <replaceable>REVISION</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -238,6 +251,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -254,6 +268,7 @@
        </orderedlist>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Commit notification; tool integration</para>
@@ -261,7 +276,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.pre-revprop-change">

      <indexterm>
@@ -284,6 +301,7 @@
          <replaceable>ACTION</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -303,6 +321,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -335,6 +354,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Access control; change validation and control</para>
@@ -342,7 +362,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.post-revprop-change">

      <indexterm>
@@ -365,6 +387,7 @@
          <replaceable>ACTION</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -387,6 +410,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -418,6 +442,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Property change notification</para>
@@ -425,7 +450,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.pre-lock">

      <indexterm>
@@ -447,6 +474,7 @@
          <replaceable>STEAL</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -481,6 +509,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -509,6 +538,7 @@
        </orderedlist>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Access control</para>
@@ -516,7 +546,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.post-lock">

      <indexterm>
@@ -535,6 +567,7 @@
          <replaceable>USER</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -551,6 +584,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -572,6 +606,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Lock notification</para>
@@ -579,7 +614,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.pre-unlock">

      <indexterm>
@@ -601,6 +638,7 @@
          <replaceable>BREAK-UNLOCK</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -620,6 +658,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -648,6 +687,7 @@
        </orderedlist>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Access control</para>
@@ -655,7 +695,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.reposhooks.post-unlock">

      <indexterm>
@@ -674,6 +716,7 @@
          <replaceable>USER</replaceable></literal></para>
      </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -690,6 +733,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Input parameter(s)</title>

@@ -711,6 +755,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Common uses</title>
        <para>Unlock notification</para>
=======================================
--- /trunk/en/book/ref-svn.xml	Tue Feb 12 12:02:17 2013
+++ /trunk/en/book/ref-svn.xml	Wed Feb 13 13:11:19 2013
@@ -1070,7 +1070,9 @@

    </partintro>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.add">

      <indexterm>
@@ -1084,10 +1086,11 @@
        <refpurpose>Add files, directories, or symbolic links.</refpurpose>
      </refnamediv>

-    <refsect1>
-      <title>Synopsis</title>
+    <refsynopsisdiv>
        <para><literal>svn add PATH...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1099,6 +1102,7 @@
          <command>svn revert</command>.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1116,6 +1120,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1178,7 +1183,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.blame">

      <indexterm>
@@ -1192,10 +1199,12 @@
        <refpurpose>Show author and revision information inline
          for the specified files or URLs.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn blame TARGET[@REV]...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1205,6 +1214,7 @@
          revision number for the last change to that line.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1221,6 +1231,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1335,7 +1346,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.cat">

      <indexterm>
@@ -1349,10 +1362,12 @@
        <refpurpose>Output the contents of the specified files or
          URLs.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn cat TARGET[@REV]...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1361,6 +1376,7 @@
          list</command> later in this chapter.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1371,6 +1387,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1434,7 +1451,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.changelist">

      <indexterm>
@@ -1448,11 +1467,13 @@
        <refpurpose>Associate (or deassociate) local paths with a
          changelist.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>changelist CLNAME TARGET...</literal></para>
        <para><literal>changelist --remove TARGET...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1463,6 +1484,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1478,6 +1500,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Example</title>

@@ -1518,7 +1541,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.checkout">

      <indexterm>
@@ -1531,10 +1556,12 @@
        <refname>svn checkout (co)</refname>
        <refpurpose>Check out a working copy from a repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn checkout URL[@REV]... [PATH]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1548,6 +1575,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1562,6 +1590,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1756,7 +1785,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.cleanup">

      <indexterm>
@@ -1769,10 +1800,12 @@
        <refname>svn cleanup</refname>
        <refpurpose>Recursively clean up the working copy</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn cleanup [PATH...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1793,6 +1826,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1804,6 +1838,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1822,7 +1857,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.commit">

      <indexterm>
@@ -1835,10 +1872,12 @@
        <refname>svn commit (ci)</refname>
        <refpurpose>Send changes from your working copy to the  
repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn commit [PATH...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1869,6 +1908,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1890,6 +1930,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1952,7 +1993,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.copy">

      <indexterm>
@@ -1967,11 +2010,11 @@
          in the repository.</refpurpose>
      </refnamediv>

-    <refsect1>
-      <title>Synopsis</title>
+    <refsynopsisdiv>
        <para><literal>svn copy SRC[@REV]... DST</literal></para>
-    </refsect1>
+    </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -2032,6 +2075,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -2051,6 +2095,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -2159,7 +2204,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.delete">

      <indexterm>
@@ -2173,11 +2220,13 @@
        <refpurpose>Delete an item from a working copy
          or the repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn delete PATH...</literal></para>
        <para><literal>svn delete URL...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -2195,6 +2244,7 @@
          committed atomically.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -2214,6 +2264,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -2300,7 +2351,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.diff">

      <indexterm>
@@ -2313,13 +2366,15 @@
        <refname>svn diff (di)</refname>
        <refpurpose>This displays the differences between two revisions or  
paths.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>diff [-c M | -r N[:M]]  
[TARGET[@REV]...]</literal></para>
        <para><literal>diff [-r N[:M]] --old=OLD-TGT[@OLDREV]  
[--new=NEW-TGT[@NEWREV]] [PATH...]</literal></para>
        <para><literal>diff OLD-URL[@OLDREV]  
NEW-URL[@NEWREV]</literal></para>

-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -2450,6 +2505,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -2475,6 +2531,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -2637,7 +2694,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.export">

      <indexterm>
@@ -2650,11 +2709,13 @@
        <refname>svn export</refname>
        <refpurpose>Export a clean directory tree.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn export [-r REV] URL[@PEGREV]  
[PATH]</literal></para>
        <para><literal>svn export [-r REV] PATH1[@PEGREV]  
[PATH2]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -2675,6 +2736,7 @@
          be copied.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -2691,6 +2753,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -2745,7 +2808,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.help">

      <indexterm>
@@ -2758,10 +2823,12 @@
        <refname>svn help (h, ?)</refname>
        <refpurpose>Help!</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn help [SUBCOMMAND...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -2770,13 +2837,16 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.import">

      <indexterm>
@@ -2790,10 +2860,12 @@
        <refpurpose>Commit an unversioned file or tree into the
          repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn import [PATH] URL</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -2808,6 +2880,7 @@
          specified.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -2829,6 +2902,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -2875,7 +2949,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.info">

      <indexterm>
@@ -2889,10 +2965,12 @@
        <refpurpose>Display information about a local or remote
          item.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn info [TARGET[@REV]...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -2913,6 +2991,7 @@
        </itemizedlist>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -2929,6 +3008,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -3039,7 +3119,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.list">

      <indexterm>
@@ -3052,10 +3134,12 @@
        <refname>svn list (ls)</refname>
        <refpurpose>List directory entries in the repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn list [TARGET[@REV]...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -3096,6 +3180,7 @@
          (<option>-v</option>) option is not accepted.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -3111,6 +3196,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -3175,7 +3261,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.lock">

      <indexterm>
@@ -3190,10 +3278,12 @@
            repository so that no other user can commit changes to
            them.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn lock TARGET...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -3206,6 +3296,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -3221,6 +3312,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -3263,7 +3355,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.log">

      <indexterm>
@@ -3276,11 +3370,13 @@
        <refname>svn log</refname>
        <refpurpose>Display commit log messages.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn log [PATH]</literal></para>
        <para><literal>svn log URL[@REV] [PATH...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -3317,6 +3413,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -3344,6 +3441,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -3633,7 +3731,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.merge">

      <indexterm>
@@ -3647,12 +3747,14 @@
        <refpurpose>Apply the differences between two sources to a
        working copy path.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn merge SOURCE[@REV]  
[TARGET_WCPATH]</literal></para>
        <para><literal>svn merge [-c M[,N...] | -r N:M ...] SOURCE[@REV]  
[TARGET_WCPATH]</literal></para>
        <para><literal>svn merge SOURCE1[@N] SOURCE2[@M]  
[TARGET_WCPATH]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -3766,6 +3868,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -3789,6 +3892,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -3847,7 +3951,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.mergeinfo">

      <indexterm>
@@ -3862,11 +3968,13 @@
          linkend="svn.branchmerge.basicmerging.mergeinfo"/> for
          details.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn mergeinfo SOURCE_URL[@REV]  
[TARGET[@REV]]</literal></para>

-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>
        <para>Query information related to merges (or potential
@@ -3882,6 +3990,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -3895,6 +4004,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -3945,7 +4055,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.mkdir">

      <indexterm>
@@ -3958,11 +4070,13 @@
        <refname>svn mkdir</refname>
        <refpurpose>Create a new directory under version  
control.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn mkdir PATH...</literal></para>
        <para><literal>svn mkdir URL...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -3978,6 +4092,7 @@
          used.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -3995,6 +4110,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -4021,7 +4137,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.move">

      <indexterm>
@@ -4034,10 +4152,12 @@
        <refname>svn move (mv)</refname>
        <refpurpose>Move a file or directory.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn move SRC... DST</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -4092,6 +4212,7 @@
          (see <xref linkend="svn.basic.in-action.mixedrevs" />).</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -4111,6 +4232,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -4154,7 +4276,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.patch">

      <indexterm>
@@ -4168,10 +4292,12 @@
        <refpurpose>Apply changes represented in a unidiff patch to
          the working copy.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn patch PATCHFILE [WCPATH]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -4258,6 +4384,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -4272,6 +4399,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -4402,7 +4530,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.propdel">

      <indexterm>
@@ -4415,11 +4545,13 @@
        <refname>svn propdel (pdel, pd)</refname>
        <refpurpose>Remove a property from an item.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svn propdel PROPNAME [PATH...]</literal></para>
        <para><literal>svn propdel PROPNAME --revprop -r REV  
[TARGET]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -4431,6 +4563,7 @@
          repository to access).</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -4446,6 +4579,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -4471,7 +4605,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svn.c.propedit">
***The diff for this file has been truncated for email.***
=======================================
--- /trunk/en/book/ref-svnadmin.xml	Tue Feb 12 08:54:42 2013
+++ /trunk/en/book/ref-svnadmin.xml	Wed Feb 13 13:11:19 2013
@@ -239,7 +239,9 @@
      </variablelist>
    </partintro>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.crashtest">

      <indexterm>
@@ -252,10 +254,12 @@
        <refname>svnadmin crashtest</refname>
        <refpurpose>Simulate a process that crashes.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin crashtest REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -268,6 +272,7 @@

        </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -275,6 +280,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -290,7 +296,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.create">

      <indexterm>
@@ -303,10 +311,12 @@
        <refname>svnadmin create</refname>
        <refpurpose>Create a new, empty repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin create REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -337,6 +347,7 @@

        </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -353,6 +364,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -383,7 +395,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.deltify">

      <indexterm>
@@ -396,10 +410,12 @@
        <refname>svnadmin deltify</refname>
        <refpurpose>Deltify changed paths in a revision range.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin deltify [-r LOWER[:UPPER]]  
REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -414,6 +430,8 @@
          this <quote>feature</quote> was deprecated.</para>

          </refsect1>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -427,7 +445,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.dump">

      <indexterm>
@@ -440,10 +460,12 @@
        <refname>svnadmin dump</refname>
        <refpurpose>Dump the contents of the filesystem to  
<filename>stdout</filename>.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin dump REPOS_PATH [-r LOWER[:UPPER]]  
[--incremental] [--deltas]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -495,6 +517,8 @@
          when using third-party tools such as <command>gzip</command>
          and <command>bzip2</command>.</para>
      </refsect1>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -509,6 +533,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -537,7 +562,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.help">

      <indexterm>
@@ -550,11 +577,12 @@
        <refname>svnadmin help (h, ?)</refname>
        <refpurpose>Help!</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin help [SUBCOMMAND...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -565,7 +593,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.hotcopy">

      <indexterm>
@@ -578,11 +608,12 @@
        <refname>svnadmin hotcopy</refname>
        <refpurpose>Make a hot copy of a repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin hotcopy REPOS_PATH  
NEW_REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -598,6 +629,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -620,7 +652,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.list-dblogs">

      <indexterm>
@@ -635,10 +669,12 @@
          given Subversion repository (applies only to repositories
          using the <literal>bdb</literal> backend).</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin list-dblogs REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -654,7 +690,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.list-unused-dblogs">

      <indexterm>
@@ -669,10 +707,12 @@
        deleted (applies only to repositories using the
        <literal>bdb</literal> backend).</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin list-unused-dblogs  
REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -686,6 +726,7 @@
          information.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -706,7 +747,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.load">

      <indexterm>
@@ -720,10 +763,12 @@
          repository dump stream from
          <filename>stdin</filename>.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin load REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -732,6 +777,7 @@
          filesystem.  Send progress feedback to  
<filename>stdout</filename>.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -749,6 +795,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -800,7 +847,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.lslocks">

      <indexterm>
@@ -813,10 +862,12 @@
        <refname>svnadmin lslocks</refname>
        <refpurpose>Print descriptions of all locks.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin lslocks REPOS_PATH  
[PATH-IN-REPOS]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -829,12 +880,14 @@
          repository.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

        <para>None</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -857,7 +910,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.lstxns">
      <indexterm>
        <primary>svnadmin</primary>
@@ -869,10 +924,12 @@
        <refname>svnadmin lstxns</refname>
        <refpurpose>Print the names of all uncommitted  
transactions.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin lstxns REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -882,6 +939,7 @@
          created and what you should do with them.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -899,7 +957,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.pack">
      <indexterm>
        <primary>svnadmin</primary>
@@ -912,10 +972,12 @@
        <refpurpose>Possibly compact the repository into a more
        efficient storage model.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin pack REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -923,6 +985,8 @@
        <xref linkend="svn.reposadmin.maint.diskspace.fsfspacking"
        /> for more information.</para>
      </refsect1>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
@@ -930,7 +994,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.recover">

      <indexterm>
@@ -949,16 +1015,20 @@
        will create a default passwordfile .</refpurpose>

      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin recover REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

        <para>Run this command if you get an error indicating that
          your repository needs to be recovered.</para>
      </refsect1>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <informalexample>
@@ -967,6 +1037,8 @@
  </screen>
        </informalexample>
      </refsect1>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1021,7 +1093,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.rmlocks">

      <indexterm>
@@ -1035,20 +1109,24 @@
        <refpurpose>Unconditionally remove one or more locks from a
        repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin rmlocks REPOS_PATH  
LOCKED_PATH...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>
        <para>Remove one or more locks from each  
<replaceable>LOCKED_PATH</replaceable>.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1068,7 +1146,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.rmtxns">

      <indexterm>
@@ -1081,10 +1161,12 @@
        <refname>svnadmin rmtxns</refname>
        <refpurpose>Delete transactions from a repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin rmtxns REPOS_PATH  
TXN_NAME...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1093,6 +1175,7 @@
          linkend="svn.reposadmin.maint.diskspace.deadtxns" />.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1103,6 +1186,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1130,7 +1214,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.setlog">

      <indexterm>
@@ -1143,10 +1229,12 @@
        <refname>svnadmin setlog</refname>
        <refpurpose>Set the log message on a revision.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin setlog REPOS_PATH -r REVISION  
FILE</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1170,6 +1258,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1181,6 +1270,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1196,7 +1286,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.setrevprop">

      <indexterm>
@@ -1209,10 +1301,12 @@
        <refname>svnadmin setrevprop</refname>
        <refpurpose>Set a property on a revision.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin setrevprop REPOS_PATH -r REVISION NAME  
FILE</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1226,6 +1320,7 @@

        </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1238,6 +1333,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1257,7 +1353,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.setuuid">

      <indexterm>
@@ -1270,10 +1368,12 @@
        <refname>svnadmin setuuid</refname>
        <refpurpose>Reset the repository UUID.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin setuuid REPOS_PATH  
[NEW_UUID]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1285,12 +1385,14 @@

        </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1313,7 +1415,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.upgrade">

      <indexterm>
@@ -1327,10 +1431,12 @@
        <refpurpose>Upgrade a repository to the latest supported
          schema version.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin upgrade REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1355,12 +1461,14 @@
        </warning>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1383,7 +1491,9 @@
    <!-- ### FIXME: This could use a lot more explanation.  When
         should I use it?  What do I do if it fails? -->

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnadmin.c.verify">

      <indexterm>
@@ -1396,10 +1506,12 @@
        <refname>svnadmin verify</refname>
        <refpurpose>Verify the data stored in the repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnadmin verify REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1417,6 +1529,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1429,6 +1542,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

=======================================
--- /trunk/en/book/ref-svndumpfilter.xml	Tue Feb 12 11:35:59 2013
+++ /trunk/en/book/ref-svndumpfilter.xml	Wed Feb 13 13:11:19 2013
@@ -94,7 +94,9 @@

    </partintro>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svndumpfilter.commands.c.exclude">

      <indexterm>
@@ -107,10 +109,12 @@
        <refname>svndumpfilter exclude</refname>
        <refpurpose>Filter out nodes with given prefixes from the dump  
stream.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svndumpfilter exclude PATH_PREFIX...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -119,6 +123,7 @@
          filtered dump file.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -135,6 +140,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -193,7 +199,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svndumpfilter.commands.c.include">

      <indexterm>
@@ -207,10 +215,12 @@
        <refpurpose>Filter out nodes without given prefixes from
          dump stream.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svndumpfilter include PATH_PREFIX...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -219,6 +229,7 @@
          filtered dump file (thus excluding all other paths).</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -235,15 +246,16 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <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>
+      <informalexample>
          <screen>
  $ svndumpfilter include sandwiches < dumpfile > filtered-dumpfile
  Including prefixes:
@@ -311,7 +323,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svndumpfilter.commands.c.help">

      <indexterm>
@@ -324,10 +338,12 @@
        <refname>svndumpfilter help</refname>
        <refpurpose>Help!</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svndumpfilter help [SUBCOMMAND...]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -338,6 +354,7 @@
          book deeply regret the omission.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
=======================================
--- /trunk/en/book/ref-svnlook.xml	Tue Feb 12 11:38:57 2013
+++ /trunk/en/book/ref-svnlook.xml	Wed Feb 13 13:11:19 2013
@@ -207,7 +207,9 @@

    </partintro>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.author">

      <indexterm>
@@ -220,10 +222,12 @@
        <refname>svnlook author</refname>
        <refpurpose>Print the author.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook author REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -231,6 +235,7 @@
          the repository.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -242,6 +247,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -258,7 +264,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.cat">

      <indexterm>
@@ -271,10 +279,12 @@
        <refname>svnlook cat</refname>
        <refpurpose>Print the contents of a file.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook cat REPOS_PATH PATH_IN_REPOS</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -282,6 +292,7 @@

        </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -293,6 +304,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -321,7 +333,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.changed">

      <indexterm>
@@ -334,10 +348,12 @@
        <refname>svnlook changed</refname>
        <refpurpose>Print the paths that were changed.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook changed REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -392,6 +408,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -404,6 +421,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -454,7 +472,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.date">

      <indexterm>
@@ -467,10 +487,12 @@
        <refname>svnlook date</refname>
        <refpurpose>Print the datestamp.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook date REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -478,6 +500,7 @@
          a repository.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -489,6 +512,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -505,7 +529,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.diff">

      <indexterm>
@@ -518,10 +544,12 @@
        <refname>svnlook diff</refname>
        <refpurpose>Print differences of changed files and  
properties.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook diff REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -529,6 +557,7 @@
          properties in a repository.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -544,6 +573,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -647,7 +677,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.dirs-changed">

      <indexterm>
@@ -660,10 +692,12 @@
        <refname>svnlook dirs-changed</refname>
        <refpurpose>Print the directories that were themselves  
changed.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook dirs-changed REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -672,6 +706,7 @@
          changed.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -683,6 +718,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -699,7 +735,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.filesize">

      <indexterm>
@@ -713,11 +751,13 @@
        <refpurpose>Print the size (in bytes) of a versioned
          file.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook filesize REPOS_PATH
          PATH_IN_REPOS</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -732,6 +772,7 @@
          whose file size you wish to display.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -743,6 +784,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -762,7 +804,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.help">

      <indexterm>
@@ -775,10 +819,12 @@
        <refname>svnlook help (h, ?)</refname>
        <refpurpose>Help!</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>Also svnlook -h and svnlook -?.</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -789,6 +835,7 @@
          it to your last party.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
@@ -796,7 +843,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.history">

      <indexterm>
@@ -811,10 +860,12 @@
          the repository (or the root directory if no path is
          supplied).</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook history REPOS_PATH  
[PATH_IN_REPOS]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -823,6 +874,7 @@
          supplied).</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -835,6 +887,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -865,7 +918,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.info">

      <indexterm>
@@ -879,10 +934,12 @@
        <refpurpose>Print the author, datestamp, log message size,
          and log message.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook info REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -890,6 +947,7 @@
          and log message, followed by a newline character.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -901,6 +959,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -921,7 +980,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.lock">

      <indexterm>
@@ -935,10 +996,12 @@
        <refpurpose>If a lock exists on a path in the repository,
          describe it.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook lock REPOS_PATH PATH_IN_REPOS</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -948,12 +1011,14 @@
          print nothing.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

        <para>None</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -976,7 +1041,9 @@
    </refentry>


-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.log">

      <indexterm>
@@ -990,16 +1057,19 @@
        <refpurpose>Print the log message, followed by a newline
          character.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook log REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

        <para>Print the log message.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1011,6 +1081,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1027,7 +1098,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.propget">

      <indexterm>
@@ -1041,10 +1114,12 @@
        <refpurpose>Print the raw value of a property on a path in
          the repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook propget REPOS_PATH PROPNAME  
[PATH_IN_REPOS]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1053,6 +1128,7 @@

        </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1066,6 +1142,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1099,7 +1176,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.proplist">

      <indexterm>
@@ -1113,10 +1192,12 @@
        <refpurpose>Print the names and values of versioned file and
          directory properties.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook proplist REPOS_PATH  
[PATH_IN_REPOS]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1126,6 +1207,7 @@

        </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1141,6 +1223,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1192,7 +1275,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.tree">
      <indexterm>
        <primary>svnlook</primary>
@@ -1204,10 +1289,12 @@
        <refname>svnlook tree</refname>
        <refpurpose>Print the tree.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook tree REPOS_PATH  
[PATH_IN_REPOS]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>
        <para>Print the tree, starting at
@@ -1216,6 +1303,7 @@
          revision IDs.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -1230,6 +1318,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Example</title>

@@ -1301,7 +1390,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.uuid">

      <indexterm>
@@ -1315,10 +1406,12 @@
        <refpurpose>Print the repository's
        <literal>UUID</literal>.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook uuid REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -1330,11 +1423,13 @@
          repository and another.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -1348,7 +1443,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnlook.c.youngest">

      <indexterm>
@@ -1361,21 +1458,25 @@
        <refname>svnlook youngest</refname>
        <refpurpose>Print the youngest revision number.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnlook youngest REPOS_PATH</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

        <para>Print the youngest revision number of a repository.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

=======================================
--- /trunk/en/book/ref-svnmucc.xml	Wed Feb 13 09:37:09 2013
+++ /trunk/en/book/ref-svnmucc.xml	Wed Feb 13 13:11:19 2013
@@ -23,7 +23,9 @@

    </partintro>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnmucc.re">

      <indexterm>
@@ -38,13 +40,11 @@
          revision.</refpurpose>
      </refnamediv>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
-    <refsect1 id="svn.ref.svnmucc.re.syn">
-      <title>Synopsis</title>
+    <refsynopsisdiv>
        <para><literal>svnmucc ACTION...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnmucc.re.desc">
        <title>Description</title>

@@ -60,7 +60,7 @@

      </refsect1>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnmucc.re.actions">
        <title>Actions</title>

@@ -166,7 +166,7 @@
        </variablelist>
      </refsect1>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnmucc.re.sw">
        <title>Options</title>

@@ -346,7 +346,7 @@
        </variablelist>
      </refsect1>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnmucc.re.examples">
        <title>Examples</title>

=======================================
--- /trunk/en/book/ref-svnrdump.xml	Tue Feb 12 11:45:09 2013
+++ /trunk/en/book/ref-svnrdump.xml	Wed Feb 13 13:11:19 2013
@@ -134,7 +134,9 @@

    </partintro>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnrdump.c.dump">

      <indexterm>
@@ -147,10 +149,12 @@
        <refname>svnrdump dump</refname>
        <refpurpose></refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnrdump dump SOURCE_URL</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -165,6 +169,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -184,6 +189,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -216,7 +222,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnrdump.c.help">

      <indexterm>
@@ -229,11 +237,12 @@
        <refname>svnrdump help</refname>
        <refpurpose>Help!</refpurpose>
      </refnamediv>
-    <refsect1>

-      <title>Synopsis</title>
+    <refsynopsisdiv>
        <para><literal>svnrdump help</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -244,6 +253,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
@@ -251,7 +261,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnrdump.c.load">

      <indexterm>
@@ -264,10 +276,12 @@
        <refname>svnrdump load</refname>
        <refpurpose></refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnrdump load DEST_URL</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -278,6 +292,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -295,6 +310,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

=======================================
--- /trunk/en/book/ref-svnserve.xml	Thu Feb  7 12:43:50 2013
+++ /trunk/en/book/ref-svnserve.xml	Wed Feb 13 13:11:19 2013
@@ -3,7 +3,9 @@
  <reference id="svn.ref.svnserve">
    <title>svnserve Reference—Custom Subversion Server</title>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnserve.re">

      <indexterm>
@@ -16,13 +18,11 @@
          custom network protocol</refpurpose>
      </refnamediv>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
-    <refsect1 id="svn.ref.svnserve.re.syn">
-      <title>Synopsis</title>
+    <refsynopsisdiv>
        <para><literal>svnserve [-d | -i | -t | -X]  
OPTIONS...</literal></para>
-    </refsect1>
+    </refsynopsisdiv>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnserve.re.desc">
        <title>Description</title>

@@ -51,7 +51,7 @@

      </refsect1>

-    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnserve.re.options">
        <title>Options</title>

=======================================
--- /trunk/en/book/ref-svnsync.xml	Tue Feb 12 12:02:17 2013
+++ /trunk/en/book/ref-svnsync.xml	Wed Feb 13 13:11:19 2013
@@ -209,7 +209,9 @@

    </partintro>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnsync.c.copy-revprops">

      <indexterm>
@@ -224,13 +226,15 @@
          revision (or range of revisions) from the source
          repository to the mirror repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnsync copy-revprops DEST_URL
          [SOURCE_URL]</literal></para>
        <para><literal>svnsync copy-revprops DEST_URL
          REV[:REV2]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -270,6 +274,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -293,6 +298,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -311,7 +317,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnsync.c.help">

      <indexterm>
@@ -324,11 +332,12 @@
        <refname>svnsync help</refname>
        <refpurpose>Help!</refpurpose>
      </refnamediv>
-    <refsect1>

-      <title>Synopsis</title>
+    <refsynopsisdiv>
        <para><literal>svnsync help</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -341,6 +350,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>
        <para>None</para>
@@ -348,7 +358,9 @@

    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnsync.c.info">

      <indexterm>
@@ -362,10 +374,12 @@
        <refpurpose>Print information about the synchronization
          of a destination repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnsync info DEST_URL</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -374,6 +388,7 @@
          destination repository at  
<replaceable>DEST_URL</replaceable>.</para>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -392,6 +407,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -411,7 +427,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnsync.c.init">

      <indexterm>
@@ -425,11 +443,13 @@
        <refpurpose>Initialize a mirror repository for
          synchronization from the source repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnsync initialize MIRROR_URL
          SOURCE_URL</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -474,6 +494,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -497,6 +518,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

@@ -529,7 +551,9 @@
      </refsect1>
    </refentry>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnsync.c.sync">

      <indexterm>
@@ -543,11 +567,13 @@
        <refpurpose>Transfer all pending revisions from the source
          repository to the mirror repository.</refpurpose>
      </refnamediv>
-    <refsect1>
-      <title>Synopsis</title>
+
+    <refsynopsisdiv>
        <para><literal>svnsync synchronize DEST_URL
          [SOURCE_URL]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>
+
+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Description</title>

@@ -583,6 +609,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Options</title>

@@ -605,6 +632,7 @@
        </informalexample>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1>
        <title>Examples</title>

=======================================
--- /trunk/en/book/ref-svnversion.xml	Tue Feb 12 12:02:17 2013
+++ /trunk/en/book/ref-svnversion.xml	Wed Feb 13 13:11:19 2013
@@ -3,7 +3,9 @@
  <reference id="svn.ref.svnversion">
    <title>svnversion Reference—Subversion Working Copy Version  
Info</title>

-  <!-- =============================================================== -->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
    <refentry id="svn.ref.svnversion.re">

      <indexterm>
@@ -12,15 +14,15 @@

      <refnamediv>
        <refname>svnversion</refname>
-      <refpurpose>Summarize the local revision(s) of a working
-                  copy.</refpurpose>
+      <refpurpose>Summarize the local revision(s) of a working
+        copy.</refpurpose>
      </refnamediv>

-    <refsect1 id="svn.ref.svnversion.re.syn">
-      <title>Synopsis</title>
+    <refsynopsisdiv>
        <para><literal>svnversion [OPTIONS] [WC_PATH  
[TRAIL_URL]]</literal></para>
-    </refsect1>
+    </refsynopsisdiv>

+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnversion.re.desc">
        <title>Description</title>

@@ -47,6 +49,7 @@

      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnversion.re.sw">
        <title>Options</title>

@@ -97,6 +100,7 @@
        </variablelist>
      </refsect1>

+    <!-- ===============================================================  
-->
      <refsect1 id="svn.ref.svnversion.re.examples">
        <title>Examples</title>





More information about the svnbook-dev mailing list