From 5df7002d1d0b8a0f58f3b976c2afd7ece9afc900 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Mon, 19 Jul 2004 17:02:34 +0000
Subject: update documentation for .5

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

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

diff --git a/man/syrep.1.xml.in b/man/syrep.1.xml.in
index ce946b7..76d2d2d 100644
--- a/man/syrep.1.xml.in
+++ b/man/syrep.1.xml.in
@@ -1,4 +1,4 @@
-<?xml version="1.0"?> <!-- -*-xae-*- -->
+<?xml version="1.0"?> <!-- -*-nxml-*- -->
 <!DOCTYPE manpage SYSTEM "xmltoman.dtd">
 <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> 
 
@@ -37,6 +37,7 @@
     <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>DIRECTORY</arg> ...</cmd>
+    <cmd>syrep [<opt>options...</opt>] <opt>--forget</opt> <arg>SNAPSHOT</arg> ...</cmd>
   </synopsis>
   
   <description> 
@@ -70,6 +71,13 @@
     <opt>--diff</opt>) or creating patches between them (command
     <opt>--make-patch</opt>).</p>
 
+    <p>Syrep will ignore all files and directories that have the
+    extended attribute <opt>user.syrep</opt> set to
+    <opt>omit</opt>. Currently, this works on Linux only. Keep in
+    mind, that only newer kernel versions and some file system support
+    extended attributes. See <manref name="attr" section="5"/> for
+    more information.</p>
+
   </description>
   
   <section name="General options">
@@ -200,6 +208,14 @@
      <p><opt>--diff</opt> (command)</p>
      <optdesc>Show difference between two repositories or snapshots</optdesc>
     </option>
+    <option>
+     <p><opt>-s</opt> | <opt>--sizes</opt> (option)</p>
+     <optdesc>Show the sizes of the files to copy. This works only when acting on a local repository and for the local files.</optdesc>
+    </option>
+    <option>
+     <p><opt>-H</opt> | <opt>--human-readable</opt> (option)</p>
+     <optdesc>Only useful when using with <opt>-s</opt>. When enabled shows file sizes in human readable form, i.e. "3.5 MB" instead of "3670016".</optdesc>
+    </option>
    </section>
 
    <section name="Merging a snapshot, a patch or a repository into a repository">
@@ -272,6 +288,18 @@
     </option>
   </section>
 
+  <section name="Forgetting outdated snapshot information">
+    <option>
+    <p><opt>--forget</opt> (command)</p>
+    <optdesc>Repackage the snapshot file dropping outdated information. Use this if your snapshot files get too large.</optdesc>
+    </option>
+    <option>
+      <p><opt>-R</opt> <arg>DAYS</arg> | <opt>--remember=</opt><arg>DAYS</arg> (option)</p>
+      <optdesc>Information about how many days in the past should be kept? This defaults to 180 (half a year).</optdesc>
+    </option>
+  </section>
+
+
   <section name="Repositories, Snapshots and Patches">
 
     <p>A syrep file repository is a POSIX file hierarchy with some
@@ -343,7 +371,7 @@
   </section>
   
   <section name="See also">
-    <p><manref name="rsync" section="1"/>, <manref name="cron" section="8"/></p>
+    <p><manref name="rsync" section="1"/>, <manref name="cron" section="8"/>, <manref name="attr" section="5"/></p>
   </section>
 
   <section name="Comments">
-- 
cgit