From b6abf79d60722dbee89e6270435d0b11c0dffa91 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Sun, 30 Nov 2003 14:27:42 +0000
Subject: relase 0.3 --copy-always --sort bi-directory merges --check-md

git-svn-id: file:///home/lennart/svn/public/syrep/trunk@43 07ea20a6-d2c5-0310-9e02-9ef735347d72
---
 man/syrep.1.xml.in | 47 +++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 39 insertions(+), 8 deletions(-)

(limited to 'man/syrep.1.xml.in')

diff --git a/man/syrep.1.xml.in b/man/syrep.1.xml.in
index 2b6e502..ce946b7 100644
--- a/man/syrep.1.xml.in
+++ b/man/syrep.1.xml.in
@@ -1,6 +1,6 @@
 <?xml version="1.0"?> <!-- -*-xae-*- -->
-<!DOCTYPE manpage SYSTEM "man.dtd">
-<?xml-stylesheet type="text/xsl" href="man.xsl" ?> 
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> 
 
 <!-- $Id$ -->
 
@@ -32,9 +32,11 @@
     <cmd>syrep [<opt>options...</opt>] <opt>--update</opt> <arg>DIRECTORY</arg> ...</cmd>
     <cmd>syrep [<opt>options...</opt>] <opt>--diff</opt> <arg>SNAPSHOT</arg> <arg>SNAPSHOT</arg></cmd>
     <cmd>syrep [<opt>options...</opt>] <opt>--merge</opt> <arg>SNAPSHOT</arg> <arg>DIRECTORY</arg></cmd>
+    <cmd>syrep [<opt>options...</opt>] <opt>--merge</opt> <arg>PATCH</arg> <arg>DIRECTORY</arg></cmd>
+    <cmd>syrep [<opt>options...</opt>] <opt>--merge</opt> <arg>DIRECTORY</arg> <arg>DIRECTORY</arg></cmd>
     <cmd>syrep [<opt>options...</opt>] <opt>--makepatch</opt> <arg>DIRECTORY</arg> <arg>SNAPSHOT</arg></cmd>
     <cmd>syrep [<opt>options...</opt>] <opt>--extract</opt> <arg>SNAPSHOT</arg> ...</cmd>
-    <cmd>syrep [<opt>options...</opt>] <opt>--cleanup</opt> <arg>SNAPSHOT</arg> ...</cmd>
+    <cmd>syrep [<opt>options...</opt>] <opt>--cleanup</opt> <arg>DIRECTORY</arg> ...</cmd>
   </synopsis>
   
   <description> 
@@ -55,7 +57,18 @@
 
     <p>Syrep is able to cope with 64 bit file sizes. (LFS)</p>
 
-    <p>Syrep is optimized for speed. It may make use of a message digest cache to accelerate the calculation of digests of a whole directory hierarchy.</p>
+    <p>Syrep is optimized for speed. It may make use of a message
+    digest cache to accelerate the calculation of digests of a whole
+    directory hierarchy.</p>
+
+    <p>A syrep repository is a normal UNIX directory tree containing a
+    special directory <file>.syrep</file> with a file
+    <file>current.syrep</file> (called snapshot) which holds file
+    system history data. A directory is turned into a syrep repository
+    by running <opt>--update</opt> on it. Snapshots are used to
+    perform basic tasks like comparing repositories (command
+    <opt>--diff</opt>) or creating patches between them (command
+    <opt>--make-patch</opt>).</p>
 
   </description>
   
@@ -121,7 +134,7 @@
 
     <option>
        <p><opt>--show-by-md</opt> (option)</p>
-       <optdesc>Show files by message digests</optdesc>
+       <optdesc>Show files by message digests. This option collides with <opt>--sort</opt>.</optdesc>
        </option>
 
     <option>
@@ -129,6 +142,11 @@
        <optdesc>Show first and last seen times</optdesc>
        </option>
 
+    <option>
+       <p><opt>--sort</opt> (option)</p>
+       <optdesc>Sort file listing chronologically. This option collides with <opt>--show-by-md</opt>.</optdesc>
+    </option>
+
   </section>
 
   <section name="Showing snapshot information">
@@ -184,23 +202,36 @@
     </option>
    </section>
 
-   <section name="Merging a snapshot into a directory">
+   <section name="Merging a snapshot, a patch or a repository into a repository">
    <option>
      <p><opt>--merge</opt> (command)</p>
-      <optdesc>Merge a snapshot or a patch into a repository. Afterwards, you should run <opt>--update</opt> on the repository to update the snapshot.</optdesc>
+      <optdesc>Merge a snapshot, a patch or a repository into a repository. Afterwards, you should run <opt>--update</opt> on the repository to update the snapshot.</optdesc>
    </option>
    <option>
       <p><opt>-q</opt> | <opt>--question</opt> (option)</p>
       <optdesc>Ask a question before each action</optdesc>
    </option>
    <option>
-      <p><opt>--prune-empty</opt> (option)</p>
+      <p><opt>-P</opt> | <opt>--prune-empty</opt> (option)</p>
       <optdesc>Prune empty directories</optdesc>
    </option>
    <option>
       <p><opt>--keep-trash</opt> (option)</p>
       <optdesc>Don't empty trash. Deleted files are copied into a trash folder inside the repository directory. If this option is specified this trash is not emptied when the operation is completed.</optdesc>
    </option>
+   <option>
+     <p><opt>--check-md</opt> (option)</p>
+     <optdesc>Check message digests of files before deleting or replacing them. NB: This worsens syrep's performance and is thus not enabled by default.</optdesc>
+   </option>
+   <option>
+     <p><opt>--always-copy</opt> (option)</p>
+     <optdesc>As default syrep tries to hard link files instead of
+     copying them. With this option syrep will always do a copy,
+     regardless if a hard link is possible or not. This is especially
+     useful when doing bi-directory merges. NB: This worsens syrep's performance and is thus not enabled by default.
+     </optdesc>
+   </option>
+
    </section>
 
    <section name="Making a patch for a snapshot against a directory">
-- 
cgit