From 177ffa0870390c6ebdb915cd03fe2b1f0e43b8e5 Mon Sep 17 00:00:00 2001
From: Brian Warner <warner@allmydata.com>
Date: Thu, 5 Feb 2009 22:14:45 -0700
Subject: [PATCH] docs/CLI: document 'tahoe backup'

---
 docs/frontends/CLI.txt | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/frontends/CLI.txt b/docs/frontends/CLI.txt
index e1553133..4ea6cf1e 100644
--- a/docs/frontends/CLI.txt
+++ b/docs/frontends/CLI.txt
@@ -197,6 +197,7 @@ tahoe cp [-r] [alias:]frompath [alias:]topath
 tahoe rm [alias:]what
 tahoe mv [alias:]from [alias:]to
 tahoe ln [alias:]from [alias:]to
+tahoe backup localfrom [alias:]to
 
 === Command Examples ===
 
@@ -332,6 +333,21 @@ tahoe mv tahoe:uploaded.txt fun:uploaded.txt
  These move a file from your tahoe root directory to the virtual directory
  set up earlier with "tahoe add-alias fun DIRCAP"
 
+tahoe backup ~ work:backups
+
+ This command performs a full versioned backup of every file and directory
+ underneath your "~" home directory, placing a read-only timestamped snapshot
+ in e.g. work:backups/Archives/2009-02-06_04:00:05Z/ (note that the timestamp
+ is in UTC, hence the "Z" suffix), and a link to the latest snapshot in
+ work:backups/Latest/ . This command will use a small SQLite database known
+ as the "backupdb", stored in ~/.tahoe/private/backupdb.sqlite, to remember
+ which local files have been backed up already, and will avoid uploading
+ files that have already been backed up. It compares timestamps and filesizes
+ when making this comparison. The "tahoe backup" command also shares
+ directories with the previous backup when nothing has changed, to run faster
+ and to reduce the number of directories created.
+
+
 == Virtual Drive Maintenance ==
 
 tahoe manifest tahoe:
-- 
2.45.2