From 326aa73a6734de61e74fd71cfdf91955a50924ef Mon Sep 17 00:00:00 2001
From: nejucomo <nejucomo@gmail.com>
Date: Tue, 20 Nov 2007 13:58:42 -0700
Subject: [PATCH] Add extensions/README and more doc strings to the fuse
 extension.

---
 contrib/README        |  3 ---
 contrib/tahoe-fuse.py | 30 ++++++++++++++++++++++++++++--
 2 files changed, 28 insertions(+), 5 deletions(-)
 delete mode 100644 contrib/README

diff --git a/contrib/README b/contrib/README
deleted file mode 100644
index ad776ba7..00000000
--- a/contrib/README
+++ /dev/null
@@ -1,3 +0,0 @@
-This directory contains code and extensions which are not strictly a part
-of Tahoe. They may or may not currently work.
-
diff --git a/contrib/tahoe-fuse.py b/contrib/tahoe-fuse.py
index 5981c4dc..ed61ac01 100644
--- a/contrib/tahoe-fuse.py
+++ b/contrib/tahoe-fuse.py
@@ -2,10 +2,36 @@
 '''
 Tahoe thin-client fuse module.
 
+
+Usage Notes:
+
+This is a proof-of-concept, and not production quality.  It uses the
+FUSE interface, and where bugs or unimplemented features are encountered
+the file system may become confused.
+
+In my experience with ubuntu's linux version 2.6.20-16-generic, and
+python-fuse version 2.5-5build1, the worst behavior is that processes
+which are accessing the fuse filesystem when some bugs occur hang.
+Also, the filesystem is currently single-threaded and blocking, so one
+bug interrupts all filesystem client processes.
+
+The rest of my system seems stable even in these cases (the rest of the
+filesystem and other processes function).
+
+The current design caches EACH FILE ENTIRELY IN MEMORY as long as any
+process has that file open.  Expect horrible memory usage.  (But also, subsequent reads after the first should be fast.  ;-)
+
+
 Goals:
+
 - Delegate to Tahoe webapi as much as possible.
-- Thin as possible.
-- This is a proof-of-concept, not a usable product.
+- Thin rather than clever.  (Even when that means clunky.)
+
+
+Status Quo:
+
+- Reads cache entire file contents, violating the thinness goal.  Can we GET spans of files?
+- Single threaded.
 '''
 
 
-- 
2.45.2