From 313876263d698b53f6f7430d12a8ce58866ac131 Mon Sep 17 00:00:00 2001
From: Brian Warner <warner@allmydata.com>
Date: Mon, 2 Jun 2008 18:00:16 -0700
Subject: [PATCH] docs/using.html: update CLI section to reflect the new alias:
 scheme. Closes #431

---
 docs/using.html | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/using.html b/docs/using.html
index e77a78b4..ee61800a 100644
--- a/docs/using.html
+++ b/docs/using.html
@@ -23,8 +23,20 @@
 
     <h1>The CLI</h1>
 
-    <p>Prefer the command-line?  Run "<cite>tahoe --help</cite>" (the same command-line tool that is used to start and stop nodes serves to navigate and use the decentralized filesystem).  To make commands like "<cite>tahoe ls</cite>" work without the <cite>--dir-cap=</cite> option, you have to put a directory capability (e.g. <cite>http://127.0.0.1:8123/uri/URI:DIR2:ovjy4yhylqlfoqg2vcze36dhde:4d4f47qko2xm5g7osgo2yyidi5m4muyo2vjjy53q4vjju2u55mfa</cite>) into <cite>~/.tahoe/private/root_dir.cap</cite>.</p>
-    <p>As with the WUI (and with all current interfaces to Tahoe), you are responsible for remembering directory capabilities yourself.  If you create a new directory and lose the capability to it, then you cannot access that directory ever again.</p>
+    <p>Prefer the command-line? Run "<cite>tahoe --help</cite>" (the same
+    command-line tool that is used to start and stop nodes serves to navigate
+    and use the decentralized filesystem). To get started, create a new
+    directory and mark it as the 'tahoe:' alias by running "<cite>tahoe
+    add-alias tahoe `tahoe mkdir`</cite>". Once you've done that, you can do
+    "<cite>tahoe ls tahoe:</cite>" and "<cite>tahoe cp LOCALFILE
+    tahoe:foo.txt</cite>" to work with your filesystem. The Tahoe CLI uses
+    the same syntax as the well-known scp and rsync tools. See <a
+    href="CLI.txt">CLI.txt</a> for more details.</p>
+
+    <p>As with the WUI (and with all current interfaces to Tahoe), you are
+    responsible for remembering directory capabilities yourself. If you
+    create a new directory and lose the capability to it, then you cannot
+    access that directory ever again.</p>
 
     <p>P.S.  "CLI" is pronounced "clee".</p>
 
-- 
2.45.2